pkgsrc-Changes-HG archive

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

[pkgsrc/trunk]: pkgsrc/doc/portability-book Removed the pkgsrc portability bo...



details:   https://anonhg.NetBSD.org/pkgsrc/rev/60e53d34dc69
branches:  trunk
changeset: 521104:60e53d34dc69
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Nov 05 09:09:20 2006 +0000

description:
Removed the pkgsrc portability book, as editing DocBook XML is no fun at
all. The contents has been moved to the NetBSD wiki at:

    http://wiki.aydogan.net/index.php/The_pkgsrc_portability_guide

diffstat:

 doc/portability-book/DESCR                 |    3 -
 doc/portability-book/Makefile              |   93 -------------
 doc/portability-book/distinfo              |    5 -
 doc/portability-book/files/Makefile        |   27 ---
 doc/portability-book/files/chapters.ent    |   10 -
 doc/portability-book/files/devices.xml     |   10 -
 doc/portability-book/files/functions.xml   |   94 -------------
 doc/portability-book/files/headers.xml     |    9 -
 doc/portability-book/files/intro.xml       |   22 ---
 doc/portability-book/files/libraries.xml   |    9 -
 doc/portability-book/files/portability.xml |   59 --------
 doc/portability-book/files/utilities.xml   |  200 -----------------------------
 12 files changed, 0 insertions(+), 541 deletions(-)

diffs (truncated from 589 to 300 lines):

diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/DESCR
--- a/doc/portability-book/DESCR        Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,3 +0,0 @@
-The pkgsrc portability book covers many of the platform-specific issues
-that are useful when writing programs that are portable to a great
-number of UNIX-like operating systems.
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/Makefile
--- a/doc/portability-book/Makefile     Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,93 +0,0 @@
-# $NetBSD: Makefile,v 1.2 2006/10/07 09:28:23 rillig Exp $
-#
-
-DISTNAME=              portability-book-${TODAY}
-CATEGORIES=            # empty
-MASTER_SITES=          ${MASTER_SITE_LOCAL}
-DISTFILES=             htdocs-share-20061007.tar.gz
-
-MAINTAINER=            rillig%NetBSD.org@localhost
-#HOMEPAGE=             http://www.NetBSD.org/Documentation/pkgsrc/
-COMMENT=               The pkgsrc portability book
-
-TODAY!=                        date '+%Y%m%d'
-DIST_SUBDIR=           pkgsrc-guide
-NO_MTREE=              yes
-USE_LANGUAGES=         # none
-
-PLIST_SRC=             ${WRKDIR}/PLIST_DYNAMIC
-DOCDIR=                        ${PREFIX}/share/doc/pkgsrc-portability
-HTDOCSDIR?=            ${.CURDIR}/../../../htdocs
-
-BUILD_DEFS+=           OUTPUTS
-OUTPUTS?=              lint html html-split ascii pdf
-
-.if defined(OUTPUTS)
-.  if !empty(OUTPUTS:Mascii)
-# the html is needed to build the ascii version.
-OUTPUTS+=              html
-.  endif
-
-# only override the Makefile.common default if it is explicitly set
-_GUIDE_OUTPUTS=                ${OUTPUTS}
-.endif
-
-DEPENDS+=              netbsd-doc-print>=1.2:../../meta-pkgs/netbsd-doc-print
-
-# The source files are only symlinked into the WRKSRC, so that they can
-# be easily modified, should the "lint" phase fail.
-pre-extract:
-       ${MKDIR} ${WRKSRC}
-       ${LN} -s ${FILESDIR}/* ${WRKSRC}
-       ln -s ${PKGSRCDIR}/doc/guide/files/share ${WRKSRC}/
-
-do-build:
-.for _output_ in ${OUTPUTS}
-       @cd ${WRKSRC} && ${SETENV} ${MAKE_ENV} ${MAKE_PROGRAM} ${MAKE_FLAGS} ${_output_}
-.endfor
-
-post-build:
-       @${RM} -f ${WRKSRC}/portability.tmp.html
-
-do-install:
-       ${INSTALL_DATA_DIR} ${DOCDIR}
-.if !empty(OUTPUTS:Mhtml) || !empty(OUTPUTS:Mhtml-split)
-       ${INSTALL_DATA} ${WRKSRC}/*.html ${DOCDIR}
-       ${INSTALL_DATA} ${WRKDIR}/htdocs/NetBSD.css ${DOCDIR}
-.endif
-.if !empty(OUTPUTS:Mascii)
-       ${INSTALL_DATA} ${WRKSRC}/portability.txt ${DOCDIR}
-.endif
-.if !empty(OUTPUTS:Mpdf)
-       ${INSTALL_DATA} ${WRKSRC}/portability.ps ${DOCDIR}
-       ${INSTALL_DATA} ${WRKSRC}/portability.pdf ${DOCDIR}
-.endif
-
-post-install:
-       ${FIND} ${DOCDIR} \( -type f -o -type l \) -print               \
-               | ${SORT} | ${SED} -e "s,${PREFIX}/,,g"                 \
-               >> ${PLIST_SRC}
-       ${FIND} ${DOCDIR} -type d -print                                \
-               | ${SORT} -r | ${SED} -e "s,${PREFIX}/,@dirrm ,g"       \
-               >> ${PLIST_SRC}
-
-do-lint:
-       cd ${WRKSRC} && ${SETENV} ${MAKE_ENV} ${MAKE_PROGRAM} lint
-
-DETAB_PROGRAM= \
-       if (/<programlisting>/ .. /<\/programlisting>/) {               \
-               while (/(.*?)\t(.*)/s) {                                \
-                       my $$filler = " " x (8 - (length($$1) % 8));    \
-                       $$_ = "$$1$$filler$$2";                         \
-               }                                                       \
-       }
-
-# remove tabulators from the <programlisting> tags.
-# TeX does not like them.
-.PHONY: detab
-detab:
-       cd ${FILESDIR} &&                                               \
-       perl -p -i".detab.tmp" -e '${DETAB_PROGRAM}' *.xml &&           \
-       ${RM} -f *.xml.detab.tmp
-
-.include "../../mk/bsd.pkg.mk"
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/distinfo
--- a/doc/portability-book/distinfo     Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,5 +0,0 @@
-$NetBSD: distinfo,v 1.2 2006/10/07 09:28:23 rillig Exp $
-
-SHA1 (pkgsrc-guide/htdocs-share-20061007.tar.gz) = b8a57eb2b7d2ae4bc632dca9e2d97ab278010e3a
-RMD160 (pkgsrc-guide/htdocs-share-20061007.tar.gz) = 6a135fea1cf25ff83dd53ded17c908911a01d2c3
-Size (pkgsrc-guide/htdocs-share-20061007.tar.gz) = 94100 bytes
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/Makefile
--- a/doc/portability-book/files/Makefile       Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,27 +0,0 @@
-# $NetBSD: Makefile,v 1.1.1.1 2006/10/06 21:10:41 rillig Exp $
-
-DOC=   portability
-
-SRCS=  portability.xml
-SRCS+= chapters.ent
-SRCS+= intro.xml
-SRCS+= utilities.xml
-SRCS+= headers.xml
-SRCS+= functions.xml
-SRCS+= devices.xml
-
-# Make deeper TOC:
-XSL_DBX_WITH_TOC_SECTION_DEPTH?= 2 
-
-# Avoid extra normalization
-NO_TIDY?=      yes
-
-
-all:   # doing this as depends doesn't work
-       ${MAKE} html-split
-       ${MAKE} html
-       ${MAKE} ascii
-       ${MAKE} pdf
-
-WEB_PREFIX=    ${.CURDIR}/../htdocs
-.include "../htdocs/share/mk/doc.docbook.mk"
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/chapters.ent
--- a/doc/portability-book/files/chapters.ent   Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,10 +0,0 @@
-<!-- $NetBSD: chapters.ent,v 1.1.1.1 2006/10/06 21:10:41 rillig Exp $ -->
-
-<!ENTITY chap.intro    SYSTEM "intro.xml">
-<!ENTITY chap.shell    SYSTEM "shell.xml">
-<!ENTITY chap.utilities        SYSTEM "utilities.xml">
-<!ENTITY chap.headers  SYSTEM "headers.xml">
-<!ENTITY chap.functions        SYSTEM "functions.xml">
-<!ENTITY chap.libraries        SYSTEM "libraries.xml">
-<!ENTITY chap.devices  SYSTEM "devices.xml">
-<!ENTITY chap.faq      SYSTEM "faq.xml">
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/devices.xml
--- a/doc/portability-book/files/devices.xml    Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,10 +0,0 @@
-<!-- $NetBSD: devices.xml,v 1.1.1.1 2006/10/06 21:10:41 rillig Exp $ -->
-
-<chapter id="dev">
-<title>Device files</title>
-
-<para>This chapter lists the device files that are available on the
-platforms and whether they are compatible to other platform's
-devices.</para>
-
-</chapter>
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/functions.xml
--- a/doc/portability-book/files/functions.xml  Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,94 +0,0 @@
-<!-- $NetBSD: functions.xml,v 1.4 2006/11/05 07:24:33 rillig Exp $ -->
-
-<chapter id="functions">
-<title>C/C++: functions</title>
-
-<para>This chapter contains the requirements for using certain functions
-in C and C++ code.</para>
-
-<sect1 id="feature">
-<title>Feature test macros</title>
-
-<para>When writing code that conforms to a specific standard, some
-programmers may want to check that really only features from that
-standard are used. For that purpose there exist a number of so-called
-feature test macros that can be defined on the command line to the
-compiler or in C and C++ source files before including any of the
-standard include files.</para>
-
-<table>
-<title>Documentation of the feature test macros</title>
-<tgroup cols="2">
-<thead>
-<row><entry>Platform</entry><entry>Location</entry></row>
-</thead>
-<tbody>
-<row><entry>SunOS-*-*</entry><entry><literal>standards(5)</literal></entry></row>
-<row><entry>NetBSD-*-*</entry><entry><filename>/usr/include/sys/featuretest.h</filename></entry></row>
-<row><entry>Linux-*-*</entry><entry><filename>/usr/include/features.h</filename></entry></row>
-</tbody>
-</tgroup>
-</table>
-
-</sect1>
-
-<sect1 id="functions.byname">
-<title>Functions on various platforms</title>
-
-<sect2 id="functions.asprintf">
-<title>asprintf</title>
-
-<para>Solaris 10 does not have this function. But it has
-<literal>snprintf</literal>, which can be used as a good replacement.</para>
-
-</sect2>
-
-<sect2 id="functions.getopt">
-<title>getopt</title>
-
-<para>Solaris provides the <function>getopt</function> function in three
-of the standard headers: &lt;stdio.h&gt;, &lt;stdlib.h&gt; and
-&lt;unistd.h&gt;, but the latter definition depends on other feature
-test macros than the first two. Additionally, since Solaris 5.10, there
-is also &lt;getopt.h&gt;, which provides
-<function>getopt_long</function>, but not <function>getopt</function>.
-The exact behavior also depends on the compiler. While SUNpro is quite
-strict and requires the feature test macros, gcc finds the definition
-without any of these macros. (TODO: Investigate further.)</para>
-
-<informaltable>
-<tgroup cols="4">
-<thead><row>
-  <entry>Platform</entry>
-  <entry>Library</entry>
-  <entry>Headers</entry>
-  <entry>Feature test macros</entry>
-</row></thead>
-
-<tbody>
-<row>
-  <entry>NetBSD-*-*</entry>
-  <entry>c</entry>
-  <entry>unistd.h</entry>
-  <entry>_POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE >= 4 || defined(_NETBSD_SOURCE)</entry>
-</row>
-<row>
-  <entry>SunOS-5.10-*</entry>
-  <entry>c</entry>
-  <entry>unistd.h</entry>
-  <entry>(_XOPEN_SOURCE && _XOPEN_VERSION == 4) || __EXTENSIONS__</entry>
-</row>
-</tbody>
-</tgroup>
-</informaltable>
-
-</sect2>
-
-<sect2 id="functions.nanosleep">
-<title>nanosleep</title>
-
-<para>On Solaris, the <literal>rt</literal> library is needed.</para>
-</sect2>
-
-</sect1>
-</chapter>
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/headers.xml
--- a/doc/portability-book/files/headers.xml    Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,9 +0,0 @@
-<!-- $NetBSD: headers.xml,v 1.1.1.1 2006/10/06 21:10:41 rillig Exp $ -->
-
-<chapter id="headers">
-<title>C/C++: Header files</title>
-
-<para>This chapter provides information about which header files are
-available on which platform.</para>
-
-</chapter>
diff -r ce04ce14f5e4 -r 60e53d34dc69 doc/portability-book/files/intro.xml
--- a/doc/portability-book/files/intro.xml      Sun Nov 05 08:37:04 2006 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,22 +0,0 @@
-<!-- $NetBSD: intro.xml,v 1.3 2006/10/20 10:15:02 rillig Exp $ -->
-
-<chapter id="intro">
-<title>Introduction</title>
-
-<para>Writing programs that are portable to a wide range of platforms
-isn't easy. Maybe some platforms are lacking your favorite tool, while
-others implemented it, but with arbitrary limitations. Some don't have
-such useful functions like <function>snprintf</function> or
-<function>strlcpy</function>.</para>
-
-<para>This book provides information about which features are
-<emphasis>not</emphasis> on the platforms, since the features that



Home | Main Index | Thread Index | Old Index