pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc/guide * Add section on editing the pkgsrc guide
details: https://anonhg.NetBSD.org/pkgsrc/rev/09068465677b
branches: trunk
changeset: 482202:09068465677b
user: hubertf <hubertf%pkgsrc.org@localhost>
date: Fri Oct 22 00:24:48 2004 +0000
description:
* Add section on editing the pkgsrc guide
* Fix capitalisation to be have only the first letter capitalized
* Mention the pkgsrc developers as contributors to the guide
diffstat:
doc/guide/Makefile | 4 +-
doc/guide/files/chapters.ent | 3 +-
doc/guide/files/editing.xml | 100 ++++++++++++++++++++++++++++++++++++++++++
doc/guide/files/features.xml | 4 +-
doc/guide/files/fixes.xml | 4 +-
doc/guide/files/pkgsrc.xml | 14 +++--
doc/guide/files/platforms.xml | 4 +-
doc/guide/files/submit.xml | 6 +-
8 files changed, 122 insertions(+), 17 deletions(-)
diffs (282 lines):
diff -r 669bec06024c -r 09068465677b doc/guide/Makefile
--- a/doc/guide/Makefile Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/Makefile Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.3 2004/10/21 23:28:57 hubertf Exp $
+# $NetBSD: Makefile,v 1.4 2004/10/22 00:24:48 hubertf Exp $
#
DISTNAME= htdocs-share-20041021
@@ -25,7 +25,7 @@
DOCDIR= ${PREFIX}/share/doc/pkgsrc
BUILD_DEFS+= OUTPUTS
-OUTPUTS?= html html-split ascii
+OUTPUTS?= html html-split ascii pdf
# the html is needed to build the ascii version.
.if !empty(OUTPUTS:Mascii)
diff -r 669bec06024c -r 09068465677b doc/guide/files/chapters.ent
--- a/doc/guide/files/chapters.ent Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/chapters.ent Fri Oct 22 00:24:48 2004 +0000
@@ -1,7 +1,7 @@
<!--
Creates entities for each chapter in the pkgsrc book.
- $NetBSD: chapters.ent,v 1.1.1.1 2004/10/21 14:27:37 grant Exp $
+ $NetBSD: chapters.ent,v 1.2 2004/10/22 00:24:48 hubertf Exp $
-->
<!-- users-guide -->
@@ -21,4 +21,5 @@
<!ENTITY chap.examples SYSTEM "examples.xml">
<!ENTITY chap.logs SYSTEM "logs.xml">
<!ENTITY chap.ftp-layout SYSTEM "ftp-layout.xml">
+<!ENTITY chap.editing SYSTEM "editing.xml">
<!ENTITY chap.platform SYSTEM "platforms.xml">
diff -r 669bec06024c -r 09068465677b doc/guide/files/editing.xml
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/guide/files/editing.xml Fri Oct 22 00:24:48 2004 +0000
@@ -0,0 +1,100 @@
+<!-- $NetBSD: editing.xml,v 1.1 2004/10/22 00:26:56 hubertf Exp $ -->
+
+<appendix id="editing">
+ <title>Editing guidelines for the pkgsrc guide</title>
+
+ <para>
+ This section contains information on editing the pkgsrc guide
+ itself.
+ </para>
+
+ <sect1>
+ <title>Targets</title>
+
+ <para>
+ The pkgsrc guide's source code is stored in
+ <filename>pkgsrc/doc/guide/files</filename>, and several files are
+ created from it:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>pkgsrc/doc/pkgsrc.txt</filename>, which replaces
+ <filename>pkgsrc/Packages.txt</filename>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>pkgsrc/doc/pkgsrc.html</filename>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>http://www.NetBSD.org/Documentation/pkgsrc/</filename>:
+ the documentation on the NetBSD website will be built from
+ pkgsrc and kept up to date on the web server itself. This
+ means you <emphasis>must</emphasis> make sure that your
+ changes haven't broken the build!
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect1>
+
+ <sect1>
+ <title>Procedure</title>
+
+ <para>
+ The procedure to edit the pkgsrc guide is:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ Edit the XML file(s) in <filename>pkgsrc/doc/guide/files</filename>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Run <command>make</command> in
+ <filename>pkgsrc/doc/guide</filename> to build the HTML and
+ ASCII version
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Run <command>make OUTPUT=pdf</command> in
+ <filename>pkgsrc/doc/guide</filename> to build the PDF
+ version. Dont' omit this, as this does a very strict SGML
+ test, and doing this properly is important for getting proper
+ documentation on the web server!
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ If all is well, run <command>make install-doc</command> to put
+ the generated files into <filename>pkgserc/doc</filename>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>cvs commit pkgsrc/doc/guide/files</command>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>cvs commit pkgsrc/doc/pkgsrc.{html,txt}</command>
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </sect1>
+</appendix>
diff -r 669bec06024c -r 09068465677b doc/guide/files/features.xml
--- a/doc/guide/files/features.xml Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/features.xml Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: features.xml,v 1.1.1.1 2004/10/21 14:27:38 grant Exp $ -->
+<!-- $NetBSD: features.xml,v 1.2 2004/10/22 00:24:48 hubertf Exp $ -->
<chapter id="features"> <?dbhtml filename="features.html"?>
<title>FAQs & features of the package system</title>
@@ -421,7 +421,7 @@
<sect1>
-<title>Software which has a WWW Home Page</title>
+<title>Software which has a homepage</title>
<para>
The NetBSD packages system now supports a variable called
diff -r 669bec06024c -r 09068465677b doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/fixes.xml Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.1.1.1 2004/10/21 14:27:40 grant Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.2 2004/10/22 00:24:48 hubertf Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Notes on fixes for packages</title>
@@ -831,7 +831,7 @@
</sect2>
<sect2>
- <title>User Interaction</title>
+ <title>User interaction</title>
<para>Occasionally, packages require interaction from the user, and this can be
in a number of ways:</para>
diff -r 669bec06024c -r 09068465677b doc/guide/files/pkgsrc.xml
--- a/doc/guide/files/pkgsrc.xml Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/pkgsrc.xml Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: pkgsrc.xml,v 1.2 2004/10/21 15:07:47 grant Exp $ -->
+<!-- $NetBSD: pkgsrc.xml,v 1.3 2004/10/22 00:24:48 hubertf Exp $ -->
<!-- From: -->
<!-- NetBSD: Packages.txt,v 1.362 2004/10/16 00:41:40 dan Exp $ -->
@@ -16,7 +16,7 @@
<book>
<bookinfo>
<title>The pkgsrc guide</title>
- <subtitle>Documentation on the NetBSD package system</subtitle>
+ <subtitle>Documentation on the NetBSD packages system</subtitle>
<authorgroup>
<author>
@@ -36,6 +36,9 @@
<address><email>hubertf%NetBSD.org@localhost</email></address>
</affiliation>
</author>
+ <corpauthor>
+ The pkgsrc Developers
+ </corpauthor>
</authorgroup>
<copyright>
@@ -44,7 +47,7 @@
<holder role="mailto:www%NetBSD.org@localhost">The NetBSD Foundation, Inc</holder>
</copyright>
- <pubdate>$NetBSD: pkgsrc.xml,v 1.2 2004/10/21 15:07:47 grant Exp $</pubdate>
+ <pubdate>$NetBSD: pkgsrc.xml,v 1.3 2004/10/22 00:24:48 hubertf Exp $</pubdate>
<abstract>
<para>Information about using the NetBSD package system (pkgsrc)
@@ -56,7 +59,7 @@
&chap.intro;
<part id="users-guide"> <?dbhtml filename="users-guide.html"?>
- <title id="users-guide.title">pkgsrc user's guide</title>
+ <title id="users-guide.title">The pkgsrc user's guide</title>
&chap.getting;
&chap.platform;
@@ -67,7 +70,7 @@
<!-- "part II" (we need to rid the documentation of this reference) -->
<part id="developers-guide"> <?dbhtml filename="developers-guide.html"?>
- <title id="developers-guide.title">pkgsrc developer's guide</title>
+ <title id="developers-guide.title">The pkgsrc developer's guide</title>
&chap.components;
&chap.plist;
@@ -83,4 +86,5 @@
&chap.examples;
&chap.logs;
&chap.ftp-layout;
+ &chap.editing;
</book>
diff -r 669bec06024c -r 09068465677b doc/guide/files/platforms.xml
--- a/doc/guide/files/platforms.xml Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/platforms.xml Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: platforms.xml,v 1.1.1.1 2004/10/21 14:27:40 grant Exp $ -->
+<!-- $NetBSD: platforms.xml,v 1.2 2004/10/22 00:24:48 hubertf Exp $ -->
<chapter id="platforms">
<title>Using pkgsrc on systems other than &os;</title>
@@ -203,7 +203,7 @@
in 3.0/3.1 is lack of pthreads.)</para>
<sect3 id="platform.interix-sfu-install">
- <title>When Installing Interix/SFU</title>
+ <title>When installing Interix/SFU</title>
<para>At an absolute minimum, the following packages must be installed from
the Windows Services for Unix 3.5 distribution in order to use pkgsrc:</para>
diff -r 669bec06024c -r 09068465677b doc/guide/files/submit.xml
--- a/doc/guide/files/submit.xml Thu Oct 21 23:55:12 2004 +0000
+++ b/doc/guide/files/submit.xml Fri Oct 22 00:24:48 2004 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: submit.xml,v 1.1.1.1 2004/10/21 14:27:40 grant Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.2 2004/10/22 00:24:48 hubertf Exp $ -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>Submitting and Committing</title>
@@ -99,7 +99,7 @@
</sect1>
<sect1>
-<title>Updating a Package to a Newer Version</title>
+<title>Updating a package to a newer version</title>
<para>
Please always put a concise, appropriate and relevant summary of the
changes between old and new versions into the commit log when updating
@@ -143,7 +143,7 @@
</sect1>
<sect1>
-<title>Moving a Package in pkgsrc</title>
+<title>Moving a package in pkgsrc</title>
<orderedlist>
<listitem><para>Make a copy of the directory somewhere else.</para></listitem>
Home |
Main Index |
Thread Index |
Old Index