pkgsrc-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[pkgsrc/trunk]: pkgsrc/doc regen



details:   https://anonhg.NetBSD.org/pkgsrc/rev/3ddd4d5542be
branches:  trunk
changeset: 517497:3ddd4d5542be
user:      wiz <wiz%pkgsrc.org@localhost>
date:      Sat Aug 12 21:30:06 2006 +0000

description:
regen

diffstat:

 doc/pkgsrc.html |  56 +++++++++++++++++++++++++++++++++-----------------------
 doc/pkgsrc.txt  |  11 ++++++++---
 2 files changed, 41 insertions(+), 26 deletions(-)

diffs (184 lines):

diff -r d43d0c6093c5 -r 3ddd4d5542be doc/pkgsrc.html
--- a/doc/pkgsrc.html   Sat Aug 12 21:29:40 2006 +0000
+++ b/doc/pkgsrc.html   Sat Aug 12 21:30:06 2006 +0000
@@ -7553,11 +7553,14 @@
 <a name="where-to-install-documentation"></a>17.5.2. Where to install documentation</h3></div></div></div>
 <p>In general, documentation should be installed into
        <code class="filename">${PREFIX}/share/doc/${PKGBASE}</code> or
-       <code class="filename">${PREFIX}/share/doc/${PKGNAME}</code> (the latter
-       includes the version number of the package).</p>
-<p>Many modern packages using GNU autoconf allow to set the directory
-       where HTML documentation is installed with the &#8220;<span class="quote">--with-html-dir</span>&#8221;
-       option.</p>
+       <code class="filename">${PREFIX}/share/doc/${PKGNAME}</code> (the
+       latter includes the version number of the package).</p>
+<p>Many modern packages using GNU autoconf allow to set the
+       directory where HTML documentation is installed with the
+       &#8220;<span class="quote">--with-html-dir</span>&#8221; option. Sometimes using this
+       flag is needed because otherwise the documentation ends up in
+       <code class="filename">${PREFIX}/share/doc/html</code> or other
+       places.</p>
 <p>An exception to the above is that library API
        documentation generated with the <a href="ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/textproc/gtk-doc/README.html"; target="_top"><code class="filename">textproc/gtk-doc</code></a> tools, 
for use by
        special browsers (devhelp) should be left at their default
@@ -7567,8 +7570,15 @@
        <code class="filename">.devhelp</code> or
        <code class="filename">.devhelp2</code>.  (It is also acceptable to
        install such files in
-       <code class="filename">${PREFIX}/share/doc</code>; no additional
-       subdirectory level is allowed in this case.)</p>
+       <code class="filename">${PREFIX}/share/doc/${PKGBASE}</code> or
+       <code class="filename">${PREFIX}/share/doc/${PKGNAME}</code>; the
+       <code class="filename">.devhelp*</code> file must be directly in that
+       directory then, no additional
+       subdirectory level is allowed in this case. This is usually
+       achieved by using
+       &#8220;<span class="quote">--with-html-dir=${PREFIX}/share/doc</span>&#8221;.
+       <code class="filename">${PREFIX}/share/gtk-doc</code> is preferred
+       though.)</p>
 </div>
 <div class="sect2" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
@@ -8275,36 +8285,36 @@
        <code class="literal">pkgsrc-users</code> mailing list.</p>
 <div class="qandaset">
 <dl>
-<dt>20.1. <a href="#id2698199">What is the difference between
+<dt>20.1. <a href="#id2698292">What is the difference between
        MAKEFLAGS, .MAKEFLAGS and
        MAKE_FLAGS?</a>
 </dt>
-<dt>20.2. <a href="#id2698235">What is the difference between
+<dt>20.2. <a href="#id2698328">What is the difference between
        MAKE, GMAKE and
        MAKE_PROGRAM?</a>
 </dt>
-<dt>20.3. <a href="#id2698342">What is the difference between
+<dt>20.3. <a href="#id2698366">What is the difference between
        CC, PKG_CC and
        PKGSRC_COMPILER?</a>
 </dt>
-<dt>20.4. <a href="#id2698379">What is the difference between
+<dt>20.4. <a href="#id2698404">What is the difference between
        BUILDLINK_LDFLAGS,
        BUILDLINK_LDADD and
        BUILDLINK_LIBS?</a>
 </dt>
-<dt>20.5. <a href="#id2698397">Why does make show-var
+<dt>20.5. <a href="#id2698422">Why does make show-var
        VARNAME=BUILDLINK_PREFIX.foo
        say it's empty?</a>
 </dt>
-<dt>20.6. <a href="#id2698425">What does
+<dt>20.6. <a href="#id2698450">What does
        ${MASTER_SITE_SOURCEFORGE:=package/} mean? I
        don't understand the := inside
        it.</a>
 </dt>
-<dt>20.7. <a href="#id2698500">Which mailing lists are there for package
+<dt>20.7. <a href="#id2698524">Which mailing lists are there for package
        developers?</a>
 </dt>
-<dt>20.8. <a href="#id2698536">Where is the pkgsrc
+<dt>20.8. <a href="#id2698561">Where is the pkgsrc
        documentation?</a>
 </dt>
 </dl>
@@ -8313,7 +8323,7 @@
 <tbody>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698199"></a><a name="id2698200"></a><b>20.1.</b>
+<a name="id2698292"></a><a name="id2698293"></a><b>20.1.</b>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
@@ -8329,7 +8339,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698235"></a><a name="id2698236"></a><b>20.2.</b>
+<a name="id2698328"></a><a name="id2698329"></a><b>20.2.</b>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
@@ -8347,7 +8357,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698342"></a><a name="id2698343"></a><b>20.3.</b>
+<a name="id2698366"></a><a name="id2698368"></a><b>20.3.</b>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
@@ -8365,7 +8375,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698379"></a><a name="id2698380"></a><b>20.4.</b>
+<a name="id2698404"></a><a name="id2698405"></a><b>20.4.</b>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -8378,7 +8388,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698397"></a><a name="id2698398"></a><b>20.5.</b>
+<a name="id2698422"></a><a name="id2698423"></a><b>20.5.</b>
 </td>
 <td align="left" valign="top"><p>Why does <span><strong class="command">make show-var
        VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
@@ -8394,7 +8404,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698425"></a><a name="id2698426"></a><b>20.6.</b>
+<a name="id2698450"></a><a name="id2698451"></a><b>20.6.</b>
 </td>
 <td align="left" valign="top"><p>What does
        <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -8418,7 +8428,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698500"></a><a name="id2698501"></a><b>20.7.</b>
+<a name="id2698524"></a><a name="id2698525"></a><b>20.7.</b>
 </td>
 <td align="left" valign="top"><p>Which mailing lists are there for package
        developers?</p></td>
@@ -8443,7 +8453,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="id2698536"></a><a name="id2698537"></a><b>20.8.</b>
+<a name="id2698561"></a><a name="id2698562"></a><b>20.8.</b>
 </td>
 <td align="left" valign="top"><p>Where is the pkgsrc
        documentation?</p></td>
diff -r d43d0c6093c5 -r 3ddd4d5542be doc/pkgsrc.txt
--- a/doc/pkgsrc.txt    Sat Aug 12 21:29:40 2006 +0000
+++ b/doc/pkgsrc.txt    Sat Aug 12 21:30:06 2006 +0000
@@ -6162,14 +6162,19 @@
 number of the package).
 
 Many modern packages using GNU autoconf allow to set the directory where HTML
-documentation is installed with the "--with-html-dir" option.
+documentation is installed with the "--with-html-dir" option. Sometimes using
+this flag is needed because otherwise the documentation ends up in ${PREFIX}/
+share/doc/html or other places.
 
 An exception to the above is that library API documentation generated with the
 textproc/gtk-doc tools, for use by special browsers (devhelp) should be left at
 their default location, which is ${PREFIX}/share/gtk-doc. Such documentation
 can be recognized from files ending in .devhelp or .devhelp2. (It is also
-acceptable to install such files in ${PREFIX}/share/doc; no additional
-subdirectory level is allowed in this case.)
+acceptable to install such files in ${PREFIX}/share/doc/${PKGBASE} or ${PREFIX}
+/share/doc/${PKGNAME}; the .devhelp* file must be directly in that directory
+then, no additional subdirectory level is allowed in this case. This is usually
+achieved by using "--with-html-dir=${PREFIX}/share/doc". ${PREFIX}/share/
+gtk-doc is preferred though.)
 
 17.5.3. Installing score files
 



Home | Main Index | Thread Index | Old Index