docbook/developer-guide.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
   4
   5 <!-- $Id$ -->
   6
   7 <!--
   8 BIOGRAPHICAL SECTION
   9 -Use this section to encode all biographical information
  10 -->
  11
  12 <!-- Authors Names -->
  13   <!ENTITY AuthorFullName "Ulf Lamping">
  14   <!ENTITY AuthorFirstName "Ulf">
  15   <!ENTITY AuthorOtherName "">
  16   <!ENTITY AuthorSurname "Lamping">
  17   <!ENTITY AuthorEmail "ulf.lamping[AT]web.de">
  18
  19 <!--Authors Affiliation -->
  20   <!ENTITY AuthorShortAffiliation "">
  21   <!ENTITY AuthorJobTitle "">
  22   <!ENTITY AuthorOrgName "">
  23   <!ENTITY AuthorOrgDiv "">
  24
  25 <!--
  26 DOCUMENT SECTION
  27 -Use this section to encode all document information
  28 -->
  29
  30   <!ENTITY DocumentTitle "<application>Wireshark</application> Developer's Guide">
  31   <!ENTITY DocumentSubTitle "&SvnVersion; for Wireshark &WiresharkCurrentVersion;">
  32   <!ENTITY DocumentTitleAbbreviation "WSDG">
  33
  34   <!ENTITY DocumentCopyrightHolder "Ulf Lamping">
  35   <!ENTITY DocumentCopyrightYear "2004-2007">
  36
  37   <!ENTITY DocumentEdition "Draft">
  38   <!ENTITY DocumentVersion "Draft 0.0.3">
  39   <!ENTITY DocumentPubDate "2007">
  40   <!ENTITY % SvnVersionFile SYSTEM "svn_version.xml">
  41   %SvnVersionFile;
  42
  43 <!ENTITY DocumentLegalNotice "<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.</para><para>All logos and trademarks in this document are property of their respective owner.</para>">
  44
  45 <!--
  46 Wireshark Info
  47 -->
  48   <!ENTITY WiresharkCurrentVersion "0.99.5">
  49   <!ENTITY WiresharkWebSite "http://www.wireshark.org">
  50   <!ENTITY WiresharkDownloadPage "&WiresharkWebSite;/download/">
  51   <!ENTITY WiresharkAuthorsPage "http://anonsvn.wireshark.org/wireshark/trunk/AUTHORS">
  52   <!ENTITY WiresharkFAQPage "&WiresharkWebSite;/faq.html">
  53   <!ENTITY WiresharkDevMailList "wireshark-dev[AT]wireshark.org">
  54   <!ENTITY WiresharkDevsGuidePage "&WiresharkWebSite;/docs/">
  55   <!ENTITY WiresharkUsersGuidePage "&WiresharkWebSite;/docs/">
  56   <!ENTITY WiresharkWikiSite "http://wiki.wireshark.org">
  57   <!ENTITY WiresharkBugsSite "http://bugs.wireshark.org">
  58
  59 <!--
  60 Gnu info
  61 -->
  62   <!ENTITY GPLWebsite "http://www.gnu.org/copyleft/gpl.html">
  63
  64 <!--
  65 FILE SECTION
  66 -Use this section to specify the files that make up the book. Use FPI (public identifiers)
  67 -->
  68
  69 <!-- These refer to graphics files and figures contained in the document -->
  70
  71   <!ENTITY WiresharkLogo SYSTEM "./wsdg_graphics/ws-logo.png" NDATA PNG>
  72   <!ENTITY WiresharkFunctionBlocks SYSTEM "./wsdg_graphics/ws-function-blocks.png" NDATA PNG>
  73
  74 <!-- These are the actual files that make up the document -->
  75
  76   <!ENTITY BookMetaInformation SYSTEM "wsdg_src/WSDG_meta_info.xml">
  77   <!ENTITY Preface SYSTEM "wsdg_src/WSDG_preface.xml">
  78   <!ENTITY EnvIntroduction SYSTEM "wsdg_src/WSDG_chapter_env_intro.xml">
  79   <!ENTITY Tools SYSTEM "wsdg_src/WSDG_chapter_tools.xml">
  80   <!ENTITY Libraries SYSTEM "wsdg_src/WSDG_chapter_libraries.xml">
  81   <!ENTITY Sources SYSTEM "wsdg_src/WSDG_chapter_sources.xml">
  82
  83   <!ENTITY BuildIntroduction SYSTEM "wsdg_src/WSDG_chapter_build_intro.xml">
  84   <!ENTITY HowWiresharkWorks SYSTEM "wsdg_src/WSDG_chapter_works.xml">
  85   <!ENTITY Capture SYSTEM "wsdg_src/WSDG_chapter_capture.xml">
  86   <!ENTITY Dissection SYSTEM "wsdg_src/WSDG_chapter_dissection.xml">
  87   <!ENTITY UserInterface SYSTEM "wsdg_src/WSDG_chapter_userinterface.xml">
  88
  89   <!ENTITY AppGPL SYSTEM    "GPL_appendix.xml">
  90
  91 <!-- These refer to graphics files and figures contained in the document -->
  92   <!-- 1st Chapter -->
  93 ]>
  94
  95 <book>
  96 <title>&DocumentTitle;</title>
  97 <subtitle>&DocumentSubTitle;</subtitle>
  98 &BookMetaInformation;
  99 &Preface;
 100 <part id="PartEnvironment" label="I">
 101 <title>Wireshark Build Environment</title>
 102 <partintro>
 103 <para>
 104 <command>Part I. Wireshark Build Environment</command>
 105 </para>
 106 <para>
 107 <command>The first part describes how to set up the tools, libraries and
 108 source needed to generate Wireshark, and how to do some typical development
 109 tasks.</command>
 110 </para>
 111 <para>
 112 Part II. Wireshark Development
 113 </para>
 114 <para>
 115 The second part describes how the Wireshark sources are structured and how
 116 to change the sources (e.g. adding a new dissector).
 117 </para>
 118 </partintro>
 119 &EnvIntroduction;
 120 &Tools;
 121 &Libraries;
 122 &Sources;
 123 </part>
 124 <part id="PartDevelopment" label="II">
 125 <title>Wireshark Development (incomplete)</title>
 126 <partintro>
 127 <!--<para>
 128 This is the second of two parts:
 129 </para>-->
 130 <para>
 131 Part I. Wireshark Build Environment
 132 </para>
 133 <para>
 134 The first part describes how to set up the tools, libraries and source needed
 135 to generate Wireshark, and how to do some typical development tasks.
 136 </para>
 137 <para>
 138 <command>Part II. Wireshark Development</command>
 139 </para>
 140 <para>
 141 <command>The second part describes how the Wireshark sources are structured and how
 142 to change the sources (e.g. adding a new dissector).</command>
 143 </para>
 144 </partintro>
 145 &HowWiresharkWorks;
 146 &BuildIntroduction;
 147 &Capture;
 148 &Dissection;
 149 &UserInterface;
 150 </part>
 151
 152 &AppGPL;
 153 <!--
 154
 155 &Glossary;
 156 &Index;  -->
 157 </book>