Reworking decompiler documentation

This commit is contained in:
caheckman 2020-01-29 11:57:33 -05:00
parent 7e5f015d65
commit 31e712b993
5 changed files with 3081 additions and 0 deletions

View File

@ -10,8 +10,12 @@ src/decompile/build.gradle||GHIDRA||||END|
src/decompile/cpp/.gitignore||GHIDRA||||END|
src/decompile/cpp/Doxyfile||GHIDRA|||Most of this file is autogenerated by doxygen which falls under the GPL - output from GPL products are NOT GPL! - mjbell4|END|
src/decompile/cpp/Makefile||GHIDRA||||END|
src/main/doc/Makefile||GHIDRA|exclude|||END|
src/main/doc/cspec.xml||GHIDRA|exclude|||END|
src/main/doc/cspec_html.xsl||GHIDRA|exclude|||END|
src/main/doc/decompileplugin.xml||GHIDRA|exclude|||END|
src/main/doc/decompileplugin_common.xsl||GHIDRA|exclude|||END|
src/main/doc/decompileplugin_html.xsl||GHIDRA|exclude|||END|
src/main/doc/main.xml||GHIDRA|exclude|reviewed||END|
src/main/doc/main_html.xsl||GHIDRA|exclude|reviewed||END|
src/main/doc/pcoderef.xml||GHIDRA|exclude|||END|

View File

@ -0,0 +1,20 @@
BUILDDIR=html
Decompiler.html: decompileplugin.xml
rm -rf ${BUILDDIR}
mkdir ${BUILDDIR}
mkdir ${BUILDDIR}/images
cp ../../../src/main/help/help/shared/Frontpage.css ${BUILDDIR}
cp ../../../src/main/help/help/shared/languages.css ${BUILDDIR}
cp ../../../src/main/help/help/topics/DecompilePlugin/images/DecompWindow.png ${BUILDDIR}/images
cp ../../../src/main/help/help/topics/DecompilePlugin/images/EditFunctionSignature.png ${BUILDDIR}/images
cp ../../../src/main/help/help/topics/DecompilePlugin/images/ForwardSlice.png ${BUILDDIR}/images
cp ../../../src/main/help/help/topics/DecompilePlugin/images/decompileFunction.gif ${BUILDDIR}/images
cp ../../../src/main/help/help/topics/DecompilePlugin/images/page_edit.png ${BUILDDIR}/images
cp ../../../../Base/src/main/help/help/topics/Snapshots/images/camera-photo.png ${BUILDDIR}/images
cp ../../../../Base/src/main/help/help/topics/ClipboardPlugin/images/page_white_copy.png ${BUILDDIR}/images
cp ../../../../../Framework/Generic/src/main/resources/images/reload3.png ${BUILDDIR}/images
cp ../../../src/main/help/help/shared/note.png ${BUILDDIR}/images
xsltproc --stringparam base.dir ${BUILDDIR} --stringparam root.filename Decompiler decompileplugin_html.xsl decompileplugin.xml
sed -i -e '/Frontpage.css/ { p; s/Frontpage.css/languages.css/; }' ${BUILDDIR}/*.html

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,59 @@
<?xml version='1.0'?>
<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:param name="generate.toc">
article/appendix nop
article title
book title,example,equation
chapter nop
part toc,title
preface toc,title
qandadiv toc
qandaset toc
reference toc,title
sect1 nop
sect2 nop
sect3 nop
sect4 nop
sect5 nop
section nop
set toc,title
</xsl:param>
<!-- Turn off automatic table numbering, adjust xref labeling -->
<xsl:param name="local.l10n.xml" select="document('')"/>
<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
<l:l10n language="en">
<l:context name="title">
<l:teamplate name="table" text="%t"/>
</l:context>
<l:context name="xref-number-and-title">
<l:template name="table" text="the table titled &#8220;%t&#8221;"/>
</l:context>
<l:context name="xref">
<l:template name="sect1" text="“%t”"/>
<l:template name="sect2" text="“%t”"/>
<l:template name="sect3" text="“%t”"/>
<l:template name="sect4" text="“%t”"/>
<l:template name="sect5" text="“%t”"/>
<l:template name="section" text="“%t”"/>
<l:template name="simplesect" text="“%t”"/>
</l:context>
</l:l10n>
</l:i18n>
<xsl:template match="table" mode="label.markup"/>
<xsl:param name="chapter.autolabel" select="0"/>
<xsl:param name="formal.title.placement"> <!-- Where does the title go, relative to the object -->
figure after
example before
equation before
table before
procedure before
task before
</xsl:param>
</xsl:stylesheet>

View File

@ -0,0 +1,56 @@
<?xml version='1.0'?>
<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl"/>
<xsl:include href="decompileplugin_common.xsl" />
<!-- Bump up the heading levels so that "chapter" gets and h1 header -->
<xsl:template name="component.title">
<xsl:param name="node" select="."/>
<xsl:variable name="level">
<xsl:choose>
<xsl:when test="ancestor::section">
<xsl:value-of select="count(ancestor::section)+1"/>
</xsl:when>
<xsl:when test="ancestor::sect">6</xsl:when>
<xsl:when test="ancestor::sect">5</xsl:when>
<xsl:when test="ancestor::sect">4</xsl:when>
<xsl:when test="ancestor::sect">3</xsl:when>
<xsl:when test="ancestor::sect">2</xsl:when>
<xsl:otherwise>1</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<!-- Let's handle the case where a component (bibliography, for example)
occurs inside a section; will we need parameters for this? -->
<xsl:element name="h{$level}">
<xsl:attribute name="class">title</xsl:attribute>
<xsl:call-template name="anchor">
<xsl:with-param name="node" select="$node"/>
<xsl:with-param name="conditional" select="0"/>
</xsl:call-template>
<xsl:apply-templates select="$node" mode="object.title.markup">
<xsl:with-param name="allow-anchors" select="1"/>
</xsl:apply-templates>
</xsl:element>
</xsl:template>
<xsl:param name="use.id.as.filename" select="1"/> <!-- Split up into files based on id attribute -->
<xsl:param name="html.stylesheet" select="'Frontpage.css'"/> <!-- Use our custom cascading style sheet -->
<xsl:param name="chunk.section.depth" select="0"/>
<xsl:param name="chunker.output.indent" select="'yes'"/> <!-- Do proper indenting of html -->
<xsl:param name="admon.graphics" select="1"/> <!-- Turn on graphic icon for important/note tags -->
<xsl:param name="admon.textlabel" select="0"/> <!-- Don't display title for important/note tags -->
<!-- <xsl:param name="admon.graphics.path" select="shared/"/> -->
</xsl:stylesheet>