pkgsrc-Changes-HG archive

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

[pkgsrc/trunk]: pkgsrc/doc doc/pkgsrc.*: regen



details:   https://anonhg.NetBSD.org/pkgsrc/rev/4afe6d9c7e3a
branches:  trunk
changeset: 337913:4afe6d9c7e3a
user:      brook <brook%pkgsrc.org@localhost>
date:      Wed Aug 14 17:38:25 2019 +0000

description:
doc/pkgsrc.*: regen

diffstat:

 doc/pkgsrc.html |  1537 +++++++++++++++++++++++++-----------------------------
 doc/pkgsrc.txt  |  1372 ++++++++++++++++++++++++------------------------
 2 files changed, 1414 insertions(+), 1495 deletions(-)

diffs (truncated from 3830 to 300 lines):

diff -r 9f4842ebe2b1 -r 4afe6d9c7e3a doc/pkgsrc.html
--- a/doc/pkgsrc.html   Wed Aug 14 17:31:34 2019 +0000
+++ b/doc/pkgsrc.html   Wed Aug 14 17:38:25 2019 +0000
@@ -163,6 +163,8 @@
 <dd><dl>
 <dt><span class="sect2"><a href="#creating.perl-module">12.1.1. Perl modules</a></span></dt>
 <dt><span class="sect2"><a href="#creating.python-module">12.1.2. Python modules and programs</a></span></dt>
+<dt><span class="sect2"><a href="#creating.R-package">12.1.3. R packages</a></span></dt>
+<dt><span class="sect2"><a href="#creating.TeX-package">12.1.4. TeXlive packages</a></span></dt>
 </dl></dd>
 <dt><span class="sect1"><a href="#creating.examples">12.2. Examples</a></span></dt>
 <dd><dl><dt><span class="sect2"><a href="#creating.nvu">12.2.1. How the www/nvu package came into pkgsrc</a></span></dt></dl></dd>
@@ -2797,6 +2799,8 @@
 <dd><dl>
 <dt><span class="sect2"><a href="#creating.perl-module">12.1.1. Perl modules</a></span></dt>
 <dt><span class="sect2"><a href="#creating.python-module">12.1.2. Python modules and programs</a></span></dt>
+<dt><span class="sect2"><a href="#creating.R-package">12.1.3. R packages</a></span></dt>
+<dt><span class="sect2"><a href="#creating.TeX-package">12.1.4. TeXlive packages</a></span></dt>
 </dl></dd>
 <dt><span class="sect1"><a href="#creating.examples">12.2. Examples</a></span></dt>
 <dd><dl><dt><span class="sect2"><a href="#creating.nvu">12.2.1. How the www/nvu package came into pkgsrc</a></span></dt></dl></dd>
@@ -3058,6 +3062,8 @@
 <dd><dl>
 <dt><span class="sect2"><a href="#creating.perl-module">12.1.1. Perl modules</a></span></dt>
 <dt><span class="sect2"><a href="#creating.python-module">12.1.2. Python modules and programs</a></span></dt>
+<dt><span class="sect2"><a href="#creating.R-package">12.1.3. R packages</a></span></dt>
+<dt><span class="sect2"><a href="#creating.TeX-package">12.1.4. TeXlive packages</a></span></dt>
 </dl></dd>
 <dt><span class="sect1"><a href="#creating.examples">12.2. Examples</a></span></dt>
 <dd><dl><dt><span class="sect2"><a href="#creating.nvu">12.2.1. How the www/nvu package came into pkgsrc</a></span></dt></dl></dd>
@@ -3229,6 +3235,47 @@
 Look inside <code class="filename">versioned_dependencies.mk</code> for a list
 of supported packages.</p>
 </div>
+<div class="sect2">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="creating.R-package"></a>12.1.3. R packages</h3></div></div></div>
+<p>Simple R packages from <a class="ulink" href="https://cran.r-project.org/web/packages/available_packages_by_name.html"; target="_top">CRAN</a>
+are handled automatically by <span class="command"><strong>R2pkg</strong></span>, which is
+available in <a href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/pkgtools/R2pkg/README.html"; target="_top"><code class="filename">pkgtools/R2pkg</code></a>.
+Individual packages (and optionally their dependencies) may be created
+and updated.  R packages generally follow the same form, and most of
+the relevant information needed is contained in a
+<code class="filename">DESCRIPTION</code> file as part of each R package on
+<a class="ulink" href="https://cran.r-project.org/web/packages/available_packages_by_name.html"; target="_top">CRAN</a>.
+Consequently, <span class="command"><strong>R2pkg</strong></span> downloads that information and
+creates or updates a package in the canonical form.  The resulting
+package should be reviewed for correctness.</p>
+</div>
+<div class="sect2">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="creating.TeX-package"></a>12.1.4. TeXlive packages</h3></div></div></div>
+<p>TeXlive packages from <a class="ulink" href="https://www.ctan.org/"; target="_top">CTAN</a> are handled automatically by
+<span class="command"><strong>texlive2pkg</strong></span>, which is available in <a href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/pkgtools/texlive2pkg/README.html"; target="_top"><code 
class="filename">pkgtools/texlive2pkg</code></a>.</p>
+<p>If the TeXlive package name is not known, it may be useful to
+search <a class="ulink" href="https://www.ctan.org/"; target="_top">CTAN</a>.  A
+<span class="quote">&#8220;<span class="quote">Contained in</span>&#8221;</span> field on the package page typically
+identifies the basename of the package file in the <a class="ulink" href="https://www.ctan.org/tex-archive/systems/texlive/tlnet/archive"; target="_top">TeXlive
+archive</a>.</p>
+<p>If the TeXlive package name is known, download the files from
+the <a class="ulink" href="https://www.ctan.org/tex-archive/systems/texlive/tlnet/archive"; target="_top">TeXlive
+archive</a>.  For package <code class="filename">foo</code>, you will need
+to download <code class="filename">foo.tar.xz</code>.  Most TeXlive packages
+also have associated documentation packages, so download
+<code class="filename">foo.doc.tar.xz</code> at the same time.  These files
+should be placed in the appropriate category directory, which is often
+but not always <code class="filename">print</code>.  Then run the following
+command in the category directory.</p>
+<pre class="programlisting">
+texlive2pkg foo.tar.xz foo.doc.tar.xz
+</pre>
+<p>This will create two packages, <code class="filename">tex-foo</code> and
+<code class="filename">tex-foo-doc</code>.  Be sure to check that both packages
+are correct.</p>
+</div>
 </div>
 <div class="sect1">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -8942,7 +8989,7 @@
        and if you still don't have the answer, ask on the
        <code class="literal">pkgsrc-users</code> mailing list.</p>
 <div class="qandaset">
-<a name="idm74633904"></a><dl>
+<a name="idp140232492973624"></a><dl>
 <dt>24.1. <a href="#devfaq.makeflags">What is the difference between
        MAKEFLAGS, .MAKEFLAGS and
        MAKE_FLAGS?</a>
@@ -8987,7 +9034,7 @@
 <tbody>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.makeflags"></a><a name="idm74633520"></a><p><b>24.1.</b></p>
+<a name="devfaq.makeflags"></a><a name="idp140232492974296"></a><p><b>24.1.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
@@ -9003,7 +9050,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.make"></a><a name="idm74637744"></a><p><b>24.2.</b></p>
+<a name="devfaq.make"></a><a name="idp140232492978760"></a><p><b>24.2.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
@@ -9021,7 +9068,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.cc"></a><a name="idm73302192"></a><p><b>24.3.</b></p>
+<a name="devfaq.cc"></a><a name="idp140232492983736"></a><p><b>24.3.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
@@ -9039,7 +9086,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3flags"></a><a name="idm73298096"></a><p><b>24.4.</b></p>
+<a name="devfaq.bl3flags"></a><a name="idp140232492988648"></a><p><b>24.4.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -9052,7 +9099,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3prefix"></a><a name="idm73295920"></a><p><b>24.5.</b></p>
+<a name="devfaq.bl3prefix"></a><a name="idp140232492991272"></a><p><b>24.5.</b></p>
 </td>
 <td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
        VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
@@ -9068,7 +9115,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.master_sites"></a><a name="idm74648624"></a><p><b>24.6.</b></p>
+<a name="devfaq.master_sites"></a><a name="idp140232492995144"></a><p><b>24.6.</b></p>
 </td>
 <td align="left" valign="top"><p>What does
        <code class="code">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -9092,7 +9139,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.mailinglists"></a><a name="idm74650032"></a><p><b>24.7.</b></p>
+<a name="devfaq.mailinglists"></a><a name="idp140232493002824"></a><p><b>24.7.</b></p>
 </td>
 <td align="left" valign="top"><p>Which mailing lists are there for package
        developers?</p></td>
@@ -9117,7 +9164,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.documentation"></a><a name="idm74654512"></a><p><b>24.8.</b></p>
+<a name="devfaq.documentation"></a><a name="idp140232493007736"></a><p><b>24.8.</b></p>
 </td>
 <td align="left" valign="top"><p>Where is the pkgsrc
        documentation?</p></td>
@@ -9165,7 +9212,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.too-much-time"></a><a name="idm74664496"></a><p><b>24.9.</b></p>
+<a name="devfaq.too-much-time"></a><a name="idp140232493016584"></a><p><b>24.9.</b></p>
 </td>
 <td align="left" valign="top"><p>I have a little time to kill.  What shall I
 do?</p></td>
@@ -10443,78 +10490,70 @@
 </tr>
 <tr>
 <td>ALL_ENV</td>
-<td>ALSA_PC</td>
-</tr>
-<tr>
 <td>ALTERNATIVES_SRC</td>
+</tr>
+<tr>
 <td>AMANDA_TMP</td>
-</tr>
-<tr>
 <td>AMANDA_USER</td>
+</tr>
+<tr>
 <td>AMANDA_VAR</td>
-</tr>
-<tr>
 <td>APACHE_GROUP</td>
+</tr>
+<tr>
 <td>APACHE_MODULE_NAME</td>
-</tr>
-<tr>
 <td>APACHE_MODULE_SRC</td>
+</tr>
+<tr>
 <td>APACHE_MODULE_SRCDIR</td>
-</tr>
-<tr>
 <td>APACHE_PKG_PREFIX</td>
+</tr>
+<tr>
 <td>APACHE_SUEXEC_CONFIGURE_ARGS</td>
-</tr>
-<tr>
 <td>APACHE_SUEXEC_DOCROOT</td>
+</tr>
+<tr>
 <td>APACHE_USER</td>
-</tr>
-<tr>
 <td>APPEND_ABI</td>
+</tr>
+<tr>
 <td>APPEND_ELF</td>
-</tr>
-<tr>
 <td>ARLA_CACHE</td>
+</tr>
+<tr>
 <td>AUDIT_PACKAGES_FLAGS</td>
-</tr>
-<tr>
 <td>AUTOCONF_REQD</td>
+</tr>
+<tr>
 <td>AUTOMAKE_OVERRIDE</td>
-</tr>
-<tr>
 <td>AUTOMAKE_REQD</td>
+</tr>
+<tr>
 <td>AUTO_MKDIRS</td>
-</tr>
-<tr>
 <td>BDB185_DEFAULT</td>
+</tr>
+<tr>
 <td>BDBBASE</td>
-</tr>
-<tr>
 <td>BDB_ACCEPTED</td>
+</tr>
+<tr>
 <td>BDB_DEFAULT</td>
-</tr>
-<tr>
 <td>BDB_LIBS</td>
+</tr>
+<tr>
 <td>BDB_TYPE</td>
-</tr>
-<tr>
 <td>BIND_DIR</td>
+</tr>
+<tr>
 <td>BIND_GROUP</td>
-</tr>
-<tr>
 <td>BIND_USER</td>
+</tr>
+<tr>
 <td>BINPKG_SITES</td>
-</tr>
-<tr>
 <td>BIN_INSTALL_FLAGS</td>
+</tr>
+<tr>
 <td>BISON_PKGDATADIR</td>
-</tr>
-<tr>
-<td>BLAS_ACCEPTED</td>
-<td>BLAS_LIBS</td>
-</tr>
-<tr>
-<td>BLAS_TYPE</td>
 <td>BOOTSTRAP_DEPENDS</td>
 </tr>
 <tr>
@@ -10627,95 +10666,83 @@
 </tr>
 <tr>
 <td>CDROM_PKG_URL_HOST</td>
-<td>CHECKOUT_DATE</td>
-</tr>
-<tr>
 <td>CHECK_FAKEHOME</td>
+</tr>
+<tr>
 <td>CHECK_FILES</td>
-</tr>
-<tr>
 <td>CHECK_FILES_SKIP</td>
+</tr>
+<tr>
 <td>CHECK_FILES_STRICT</td>
-</tr>
-<tr>
 <td>CHECK_HEADERS</td>
+</tr>



Home | Main Index | Thread Index | Old Index