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: <stdio.h>, <stdlib.h> and
-<unistd.h>, but the latter definition depends on other feature
-test macros than the first two. Additionally, since Solaris 5.10, there
-is also <getopt.h>, 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