X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fdeveloper-manual%2Fdocumentation.html;h=83a505307ce6edc795f8162bf38efa243c52e2b9;hp=ba6f74146ec855895e4c42f07bc523f2dbbe040a;hb=659cbbc13f413ed0c5dacd4d03060f48eb500011;hpb=3c890b0540031fa87cc28514b3e4d0e23124fbcd diff --git a/doc/webserver/developer-manual/documentation.html b/doc/webserver/developer-manual/documentation.html index ba6f7414..83a50530 100644 --- a/doc/webserver/developer-manual/documentation.html +++ b/doc/webserver/developer-manual/documentation.html @@ -1,4 +1,4 @@ - + <LINK REL="PREVIOUS" -TITLE="The CVS Repository" -HREF="cvs.html"><LINK +TITLE="The Git Repository" +HREF="git.html"><LINK REL="NEXT" TITLE="Coding Guidelines" HREF="coding.html"><LINK @@ -48,7 +48,7 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="cvs.html" +HREF="git.html" ACCESSKEY="P" >Prev</A ></TD @@ -86,7 +86,7 @@ CLASS="COMPUTEROUTPUT" >doc/source/*</SAMP > directory. You will need <A -HREF="http://www.docbook.org" +HREF="https://www.docbook.org/" TARGET="_top" >Docbook</A >, the Docbook @@ -132,7 +132,7 @@ CLASS="CITETITLE" >, <I CLASS="CITETITLE" ->privoxy.1</I +>privoxy.8</I > (man page), and <I CLASS="CITETITLE" @@ -173,16 +173,6 @@ CLASS="CITETITLE" process requires going from SGML to HTML to text to special formatting required for the embedded comments. Some of this does not survive so well. Especially some of the examples that are longer than 80 characters. - The build process for this file outputs to <TT -CLASS="FILENAME" ->config.new</TT ->, - which should be reviewed for errors and mis-formatting. Once satisfied - that it is correct, then it should be hand copied to - <TT -CLASS="FILENAME" ->config</TT ->. </P ><P > Other, less formal documents (e.g. <TT @@ -194,7 +184,7 @@ CLASS="FILENAME" ><P > Packagers are encouraged to include this documentation. For those without the ability to build the docs locally, text versions of each are kept in - CVS. HTML versions are also being kept in CVS under + Git. HTML versions are also being kept in Git under <TT CLASS="FILENAME" >doc/webserver/*</TT @@ -222,7 +212,7 @@ CLASS="COMPUTEROUTPUT" </P ><P > Documentation writers should please make sure documents build - successfully before committing to CVS, if possible. + successfully before committing to Git, if possible. </P ><P > How do you update the webserver (i.e. the pages on privoxy.org)? @@ -236,7 +226,7 @@ TYPE="1" > First, build the docs by running <SAMP CLASS="COMPUTEROUTPUT" >make - dok</SAMP + dok dok-tidy</SAMP >. </P ></LI @@ -250,12 +240,12 @@ CLASS="COMPUTEROUTPUT" CLASS="COMPUTEROUTPUT" >doc/webserver</SAMP > to the - sourceforge webserver via scp. + sourceforge webserver via ssh. </P ></LI ></OL ><P -> Finished docs should be occasionally submitted to CVS +> Finished docs should be occasionally submitted to Git (<TT CLASS="FILENAME" >doc/webserver/*/*.html</TT @@ -324,8 +314,8 @@ CLASS="QUOTE" >. If not, you will likely generate errors. Example: <TT CLASS="LITERAL" -><title>My - Title</title></TT +><title>My + Title</title></TT >. They are also case-insensitive, but we strongly suggest using all lower case. This keeps compatibility with [Docbook] <SPAN @@ -366,11 +356,11 @@ CLASS="LITERAL" > will not. Each section requires a <TT CLASS="LITERAL" -><title></TT +><title></TT > element, and at least one <TT CLASS="LITERAL" -><para></TT +><para></TT >. There is a limit of five section levels in Docbook, but generally three should be sufficient for our purposes.</P @@ -387,7 +377,7 @@ BORDER="0" CLASS="emphasis" ><I CLASS="EMPHASIS" -><para></para></I +><para></para></I ></SPAN >, paragraph delimiter. Most text needs to be within paragraph elements (there are some exceptions). @@ -399,7 +389,7 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><emphasis></emphasis></I +><emphasis></emphasis></I ></SPAN >, the stylesheets make this italics. @@ -411,7 +401,7 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><filename></filename></I +><filename></filename></I ></SPAN >, files and directories. </TD @@ -422,7 +412,7 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><command></command></I +><command></command></I ></SPAN >, command examples. </TD @@ -433,12 +423,12 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><literallayout></literallayout></I +><literallayout></literallayout></I ></SPAN >, like <TT CLASS="LITERAL" -><pre></TT +><pre></TT >, more or less. </TD ></TR @@ -448,7 +438,7 @@ CLASS="LITERAL" CLASS="emphasis" ><I CLASS="EMPHASIS" -><itemizedlist></itemizedlist></I +><itemizedlist></itemizedlist></I ></SPAN >, list with bullets. </TD @@ -459,7 +449,7 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><listitem></listitem></I +><listitem></listitem></I ></SPAN >, member of the above. </TD @@ -470,12 +460,12 @@ CLASS="EMPHASIS" CLASS="emphasis" ><I CLASS="EMPHASIS" -><screen></screen></I +><screen></screen></I ></SPAN >, screen output, implies <TT CLASS="LITERAL" -><literallayout></TT +><literallayout></TT >. </TD ></TR @@ -485,12 +475,12 @@ CLASS="LITERAL" CLASS="emphasis" ><I CLASS="EMPHASIS" -><ulink url="example.com"></ulink></I +><ulink url="example.com"></ulink></I ></SPAN >, like HTML <TT CLASS="LITERAL" -><a></TT +><a></TT > tag. </TD ></TR @@ -500,7 +490,7 @@ CLASS="LITERAL" CLASS="emphasis" ><I CLASS="EMPHASIS" -><quote></quote></I +><quote></quote></I ></SPAN >, for, doh, quoting text. </TD @@ -513,7 +503,7 @@ CLASS="EMPHASIS" > Look at any of the existing docs for examples of all these and more.</P ><P > You might also find - + <SPAN CLASS="QUOTE" >"<A @@ -563,17 +553,15 @@ CLASS="EMPHASIS" </P ><P CLASS="LITERALLAYOUT" -> <para><br> +> <para><br>   Some text goes here.<br> - </para><br> -       </P + </para></P ><P > Tags marking individual words, or few words, should be in-line: </P ><P CLASS="LITERALLAYOUT" ->  Just to <emphasis>emphasize</emphasis>, some text goes here.<br> -       </P +>  Just to <emphasis>emphasize</emphasis>, some text goes here.</P ></LI ><LI ><P @@ -582,16 +570,15 @@ CLASS="LITERALLAYOUT" </P ><P CLASS="LITERALLAYOUT" -> <para><br> -  <itemizedlist><br> -   <para><br> -    <listitem><br> +> <para><br> +  <itemizedlist><br> +   <para><br> +    <listitem><br>       Some text goes here in our list example.<br> -     </listitem><br> -   </para><br> -  </itemizedlist><br> - </para><br> -       </P +     </listitem><br> +   </para><br> +  </itemizedlist><br> + </para></P ><P > This makes it easier to find the text amongst the tags ;-) </P @@ -606,9 +593,9 @@ CLASS="LITERALLAYOUT" ><LI ><P > Do not hesitate to make comments. Comments can either use the - <comment> element, or the <!-- --> style comment - familiar from HTML. (Note in Docbook v4.x <comment> is - replaced by <remark>.) + <comment> element, or the <!-- --> style comment + familiar from HTML. (Note in Docbook v4.x <comment> is + replaced by <remark>.) </P ></LI ><LI @@ -629,11 +616,11 @@ CLASS="LITERALLAYOUT" ><P > Our documents are available in differing formats. Right now, they are just plain text and/or HTML, but others are always a - future possibility. Be careful with URLs (<ulink>), and avoid + future possibility. Be careful with URLs (<ulink>), and avoid this mistake: </P ><P -> My favorite site is <ulink url="http://example.com">here</ulink>. +> My favorite site is <ulink url="http://example.com">here</ulink>. </P ><P > This will render as <SPAN @@ -643,7 +630,7 @@ CLASS="QUOTE" not real helpful in a text doc. Better like this: </P ><P -> My favorite site is <ulink url="http://example.com">example.com</ulink>. +> My favorite site is <ulink url="http://example.com">example.com</ulink>. </P ></LI ><LI @@ -670,7 +657,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN206" +NAME="CUSTOM-ENTITIES" >3.3. Privoxy Custom Entities</A ></H2 ><P @@ -736,7 +723,7 @@ CLASS="QUOTE" ><P > <TT CLASS="LITERAL" -><!entity supported SYSTEM "supported.sgml"></TT +><!entity supported SYSTEM "supported.sgml"></TT > </P ><P @@ -780,7 +767,7 @@ CLASS="APPLICATION" > version string, e.g. <SPAN CLASS="QUOTE" ->"3.0.27"</SPAN +>"3.0.34"</SPAN >. </TD ></TR @@ -873,7 +860,7 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="cvs.html" +HREF="git.html" ACCESSKEY="P" >Prev</A ></TD @@ -901,7 +888,7 @@ ACCESSKEY="N" WIDTH="33%" ALIGN="left" VALIGN="top" ->The CVS Repository</TD +>The Git Repository</TD ><TD WIDTH="34%" ALIGN="center"