Skip to content

Commit

Permalink
Add a help section
Browse files Browse the repository at this point in the history
  • Loading branch information
antoniovazquezblanco committed Sep 30, 2024
1 parent 99026ae commit 831e1c2
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 63 deletions.
52 changes: 1 addition & 51 deletions src/main/help/help/TOC_Source.xml
Original file line number Diff line number Diff line change
@@ -1,57 +1,7 @@
<?xml version='1.0' encoding='ISO-8859-1' ?>
<!--
This is an XML file intended to be parsed by the Ghidra help system. It is loosely based
upon the JavaHelp table of contents document format. The Ghidra help system uses a
TOC_Source.xml file to allow a module with help to define how its contents appear in the
Ghidra help viewer's table of contents. The main document (in the Base module)
defines a basic structure for the
Ghidra table of contents system. Other TOC_Source.xml files may use this structure to insert
their files directly into this structure (and optionally define a substructure).
In this document, a tag can be either a <tocdef> or a <tocref>. The former is a definition
of an XML item that may have a link and may contain other <tocdef> and <tocref> children.
<tocdef> items may be referred to in other documents by using a <tocref> tag with the
appropriate id attribute value. Using these two tags allows any module to define a place
in the table of contents system (<tocdef>), which also provides a place for
other TOC_Source.xml files to insert content (<tocref>).
During the help build time, all TOC_Source.xml files will be parsed and validated to ensure
that all <tocref> tags point to valid <tocdef> tags. From these files will be generated
<module name>_TOC.xml files, which are table of contents files written in the format
desired by the JavaHelp system. Additionally, the genated files will be merged together
as they are loaded by the JavaHelp system. In the end, when displaying help in the Ghidra
help GUI, there will be on table of contents that has been created from the definitions in
all of the modules' TOC_Source.xml files.
Tags and Attributes
<tocdef>
-id - the name of the definition (this must be unique across all TOC_Source.xml files)
-text - the display text of the node, as seen in the help GUI
-target** - the file to display when the node is clicked in the GUI
-sortgroup - this is a string that defines where a given node should appear under a given
parent. The string values will be sorted by the JavaHelp system using
a javax.text.RulesBasedCollator. If this attribute is not specified, then
the text of attribute will be used.
<tocref>
-id - The id of the <tocdef> that this reference points to
**The URL for the target is relative and should start with 'help/topics'. This text is
used by the Ghidra help system to provide a universal starting point for all links so that
they can be resolved at runtime, across modules.
-->


<tocroot>
<!-- Uncomment and adjust fields to add help topic to help system's Table of Contents
<tocref id="Ghidra Functionality">
<tocdef id="HelpAnchor" text="My Feature" target="help/topics/my_topic/help.html" />
<tocdef id="Device Tree Blob Importer" text="Device Tree Blob Importer" target="help/topics/devicetreeblob/help.html" />
</tocref>
-->
</tocroot>
31 changes: 19 additions & 12 deletions src/main/help/help/topics/devicetreeblob/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,22 +2,29 @@

<HTML>
<HEAD>
<META name="generator" content=
"HTML Tidy for Java (vers. 2009-12-01), see jtidy.sourceforge.net">
<META http-equiv="Content-Language" content="en-us">
<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
<META name="GENERATOR" content="Microsoft FrontPage 4.0">
<META name="ProgId" content="FrontPage.Editor.Document">

<TITLE>Skeleton Help File for a Module</TITLE>
<TITLE>Device Tree Blob Importer</TITLE>
<LINK rel="stylesheet" type="text/css" href="help/shared/DefaultStyle.css">
</HEAD>

<BODY>
<H1><a name="HelpAnchor"></a>Skeleton Help File for a Module</H1>
<H1><a name="DeviceTreeBlob"></a>Device Tree Blob Importer</H1>

<P>
The <I>Device Tree Blob Importer</I> reconstructs memory map information
from flattened device tree files (DTB or FDT files).
</P>

<P>This is a simple skeleton help topic. For a better description of what should and should not
go in here, see the "sample" Ghidra extension in the Extensions/Ghidra directory, or see your
favorite help topic. In general, language modules do not have their own help topics.</P>
<P>
In order to import memory map information from device tree files, use the
<B>Import DTB...</B> item in the <B>File</B> menu.
</P>

<P align="left" class="providedbyplugin">
Provided by: <I>GhidraDeviceTreeBlob</I> plugin
</P>
<P>&nbsp;</P>
<BR>
<BR>
<BR>
</BODY>
</HTML>

0 comments on commit 831e1c2

Please sign in to comment.