diff options
author | Mark Wielaard <mjw@redhat.com> | 2010-01-01 20:47:26 +0100 |
---|---|---|
committer | Mark Wielaard <mjw@redhat.com> | 2010-01-02 00:07:00 +0100 |
commit | 53ade4da49f02bedf5c0e7e0b82d961b3e78cb4d (patch) | |
tree | 4ba68c78843cb47e102b7c988cb17a96ff8c2438 /doc | |
parent | 72f28cc2cb57bbcc4e773069dad6cf75343fb396 (diff) | |
download | systemtap-steved-53ade4da49f02bedf5c0e7e0b82d961b3e78cb4d.tar.gz systemtap-steved-53ade4da49f02bedf5c0e7e0b82d961b3e78cb4d.tar.xz systemtap-steved-53ade4da49f02bedf5c0e7e0b82d961b3e78cb4d.zip |
Add SystemTap_Beginners_Guide to build.
* configure.ac: Add --enable-publican and --with-publican-brand.
Setup "shadow" directory doc/beginners.
* Makefile.in: Regenerated.
* configure: Regenerated.
* doc/Makefile.am (SUBDIRS): Add beginners.
* doc/Makefile.in: Regenerated.
* doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml (productname):
Set to Systemtap.
(productnumber): Set to 1.0.
* SystemTap_Beginners_Guide/en-US/*.xml: Replace includes from
extras/testsuite to ../testsuite,
* doc/SystemTap_Beginners_Guide/publican.cfg: Moved to ...
* doc/SystemTap_Beginners_Guide/publican.cfg.in: ... here.
* doc/SystemTap_Beginners_Guide/Makefile: Removed.
* doc/SystemTap_Beginners_Guide/old-syncandbuild.sh: Removed.
* doc/SystemTap_Beginners_Guide/syncandbuild.sh: Removed.
* doc/SystemTap_Tapset_Reference/Makefile.in: Regenerated.
* doc/beginners/Makefile.am: New makefile.
* doc/beginners/Makefile.in: New generated file.
* grapher/Makefile.in: Regenerated.
* systemtap.spec: Add with_publican and publican_brand.
Diffstat (limited to 'doc')
27 files changed, 487 insertions, 115 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index 55291f7f..ae129c4f 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -3,7 +3,7 @@ PDF_FILES = tutorial.pdf langref.pdf DOC_INSTALL_DIR = $(DESTDIR)$(datadir)/doc/systemtap -SUBDIRS = SystemTap_Tapset_Reference +SUBDIRS = SystemTap_Tapset_Reference beginners if BUILD_DOCS all-local: $(PDF_FILES) diff --git a/doc/Makefile.in b/doc/Makefile.in index 71004965..6ba0e04e 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -143,6 +143,7 @@ PIECFLAGS = @PIECFLAGS@ PIECXXFLAGS = @PIECXXFLAGS@ PIELDFLAGS = @PIELDFLAGS@ PKG_CONFIG = @PKG_CONFIG@ +PUBLICAN_BRAND = @PUBLICAN_BRAND@ RANLIB = @RANLIB@ RPM_CFLAGS = @RPM_CFLAGS@ RPM_LIBS = @RPM_LIBS@ @@ -178,6 +179,7 @@ have_dvips = @have_dvips@ have_latex = @have_latex@ have_latex2html = @have_latex2html@ have_ps2pdf = @have_ps2pdf@ +have_publican = @have_publican@ have_xmlto = @have_xmlto@ host_alias = @host_alias@ htmldir = @htmldir@ @@ -214,7 +216,7 @@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ PDF_FILES = tutorial.pdf langref.pdf DOC_INSTALL_DIR = $(DESTDIR)$(datadir)/doc/systemtap -SUBDIRS = SystemTap_Tapset_Reference +SUBDIRS = SystemTap_Tapset_Reference beginners SUFFIXES = ps pdf dvi ps tex all: all-recursive diff --git a/doc/SystemTap_Beginners_Guide/Makefile b/doc/SystemTap_Beginners_Guide/Makefile deleted file mode 100644 index 5c9c2379..00000000 --- a/doc/SystemTap_Beginners_Guide/Makefile +++ /dev/null @@ -1,22 +0,0 @@ -#Makefile for SystemTap_Beginners_Guide - -XML_LANG = en-US - -BRAND = fedora -# please define the BRAND in the pre:: section below -#SHOW_REMARKS = 1 - -#OTHER_LANGS = as-IN bn-IN de-DE es-ES fr-FR gu-IN hi-IN it-IT ja-JP kn-IN ko-KR ml-IN mr-IN or-IN pa-IN pt-BR ru-RU si-LK ta-IN te-IN zh-CN zh-TW - -CONDITION=$(BRAND) - -COMMON_CONFIG = /usr/share/publican -include $(COMMON_CONFIG)/make/Makefile.common - -pre:: - cp -a ../../testsuite en-US/extras/; - -post:: - rm -rf en-US/extras/testsuite - sed -i -e 's/<productname>Fedora/<productname>Red Hat Enterprise Linux/g' en-US/Book_Info.xml; - sed -i -e 's/<productnumber>10/<productnumber>5/g' en-US/Book_Info.xml; diff --git a/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml b/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml index fb6bec20..6c847140 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml @@ -5,11 +5,11 @@ <bookinfo id="SystemTap_Beginners_Guide"> <title>SystemTap Beginners Guide</title> <subtitle condition="RedHat">Introduction to SystemTap (for Red Hat Enterprise Linux 5.4)</subtitle> -<!-- <subtitle condition="fedora">Introduction to SystemTap (for Fedora 10)</subtitle> --> + <subtitle condition="fedora">Introduction to SystemTap (for Fedora 10)</subtitle> <edition>2.0</edition> - <productname>Red Hat Enterprise Linux</productname> - <productnumber>5.4</productnumber> + <productname>Systemtap</productname> + <productnumber>1.0</productnumber> <pubsnumber>2</pubsnumber> <abstract condition="RedHat"><para>This guide provides basic instructions on how to use SystemTap to monitor different subsystems of &PRODUCT; in finer detail. The <citetitle>SystemTap Beginners Guide</citetitle> is recommended for users who have taken <ulink url="https://www.redhat.com/courses/rh133_red_hat_linux_system_administration_and_rhct_exam/">RHCT</ulink> or have a similar level of expertise in &PRODUCT;.</para></abstract> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml index 8a786d82..781ea949 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml @@ -65,7 +65,7 @@ <title>disktop.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/io/disktop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/io/disktop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml index 3bc69899..53891bed 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml @@ -49,7 +49,7 @@ discard packets every five-second interval. <title>dropwatch.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/network/dropwatch.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/network/dropwatch.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-functioncalls.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-functioncalls.xml index 6a5c8f4d..0d0aa947 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-functioncalls.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-functioncalls.xml @@ -47,7 +47,7 @@ no script in examples <title>functioncallcount.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/profiling/functioncallcount.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/profiling/functioncallcount.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-futexes.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-futexes.xml index 82bb762b..2426da8d 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-futexes.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-futexes.xml @@ -87,7 +87,7 @@ no script in examples <title>futexes.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/process/futexes.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/process/futexes.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-ioblktime.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-ioblktime.xml index e586d81a..b3753e0c 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-ioblktime.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-ioblktime.xml @@ -39,7 +39,7 @@ <title>ioblktime.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/io/ioblktime.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/io/ioblktime.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml index c5bbb480..2bb0c778 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml @@ -35,7 +35,7 @@ <title>iotop.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/io/iotop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/io/iotop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml index 2d7e3595..1a9978dc 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml @@ -44,7 +44,7 @@ <title>nettop.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/network/nettop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/network/nettop.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-sockettrace.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-sockettrace.xml index 6e913b48..8bce5a41 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-sockettrace.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-sockettrace.xml @@ -51,7 +51,7 @@ <title>socket-trace.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/network/socket-trace.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/network/socket-trace.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-syscallsbyprocpid.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-syscallsbyprocpid.xml index d8fe4b39..92727821 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-syscallsbyprocpid.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-syscallsbyprocpid.xml @@ -53,7 +53,7 @@ uses systemtap/testsuite/systemtap.examples/process/syscalls_by_p*.stp <title>syscalls_by_proc.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/process/syscalls_by_proc.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/process/syscalls_by_proc.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> @@ -97,7 +97,7 @@ Collecting data... Type Ctrl-C to exit and display results <title>syscalls_by_pid.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/process/syscalls_by_pid.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/process/syscalls_by_pid.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcp_connections.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcp_connections.xml index c25465b4..6dc2d2b1 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcp_connections.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcp_connections.xml @@ -54,7 +54,7 @@ <title>tcp_connections.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/network/tcp_connections.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/network/tcp_connections.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcpdumplike.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcpdumplike.xml index cd42edc6..dfd3fac8 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcpdumplike.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-tcpdumplike.xml @@ -54,7 +54,7 @@ <title>tcpdumplike.stp</title> <para> <programlisting> - <xi:include parse="text" href="extras/testsuite/systemtap.examples/network/tcpdumplike.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include parse="text" href="../testsuite/systemtap.examples/network/tcpdumplike.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-threadtimes.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-threadtimes.xml index 3bddf067..193012ea 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-threadtimes.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-threadtimes.xml @@ -43,7 +43,7 @@ <title>thread-times.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/profiling/thread-times.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/profiling/thread-times.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-timeout.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-timeout.xml index 719f5c6d..1f7b7a11 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-timeout.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-timeout.xml @@ -47,7 +47,7 @@ uses systemtap/testsuite/systemtap.examples/profiling/timeout.stp <title>timeout.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/profiling/timeout.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/profiling/timeout.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-topsys.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-topsys.xml index 700ef4ed..ba814d5e 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-topsys.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-topsys.xml @@ -62,7 +62,7 @@ uses systemtap/testsuite/systemtap.examples/profiling/topsys.stp <title>topsys.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/profiling/topsys.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/profiling/topsys.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml index 1af1475d..d3e04eff 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml @@ -42,7 +42,7 @@ <title>traceio.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/io/traceio.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/io/traceio.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio2.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio2.xml index 7451de98..aed8c508 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio2.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio2.xml @@ -53,7 +53,7 @@ <title>traceio2.stp</title> <para> <programlisting> -<xi:include parse="text" href="extras/testsuite/systemtap.examples/io/traceio2.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<xi:include parse="text" href="../testsuite/systemtap.examples/io/traceio2.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /> </programlisting> </para> </formalpara> diff --git a/doc/SystemTap_Beginners_Guide/old-syncandbuild.sh b/doc/SystemTap_Beginners_Guide/old-syncandbuild.sh deleted file mode 100755 index e6a6c1f4..00000000 --- a/doc/SystemTap_Beginners_Guide/old-syncandbuild.sh +++ /dev/null @@ -1,25 +0,0 @@ -#!/bin/bash -# Instead of running the original makefile to build the document, run this script instead -echo -n "Please specify your build target (e.g. html, pdf, or html-single) " -read TARG -echo -n "Please specify the product you are building for (enter 1 for Fedora, 2 for RHEL) " -read PROD -echo -n "Please specify any build parameters you'd like to use (skip this step for none). " -read PARM - -if [ $PROD = 1 ]; -then - sed -i -e 's/<productname>Red Hat Enterprise Linux/<productname>Fedora/g' en-US/Book_Info.xml; - sed -i -e 's/<productnumber>5/<productnumber>10/g' en-US/Book_Info.xml; - sed -i -e 's/BRAND = RedHat/BRAND = fedora/g' Makefile; - make $PARM $TARG-en-US post - -else -sed -i -e 's/BRAND = fedora/BRAND = RedHat/g' Makefile; -make post $PARM $TARG-en-US -fi - -echo "done." -echo "Cleaning sync'd files..." -make post -echo "...done."
\ No newline at end of file diff --git a/doc/SystemTap_Beginners_Guide/publican.cfg b/doc/SystemTap_Beginners_Guide/publican.cfg deleted file mode 100644 index cc174563..00000000 --- a/doc/SystemTap_Beginners_Guide/publican.cfg +++ /dev/null @@ -1,8 +0,0 @@ -# Config::Simple 4.59 -# Tue Dec 1 09:26:42 2009 - -debug: 1 -xml_lang: en-US -brand: fedora -condition: fedora - diff --git a/doc/SystemTap_Beginners_Guide/publican.cfg.in b/doc/SystemTap_Beginners_Guide/publican.cfg.in new file mode 100644 index 00000000..d6cbacde --- /dev/null +++ b/doc/SystemTap_Beginners_Guide/publican.cfg.in @@ -0,0 +1,5 @@ +debug: 0 +xml_lang: en-US +brand: @PUBLICAN_BRAND@ +condition: @PUBLICAN_BRAND@ +tmp_dir: build diff --git a/doc/SystemTap_Beginners_Guide/syncandbuild.sh b/doc/SystemTap_Beginners_Guide/syncandbuild.sh deleted file mode 100755 index 00084985..00000000 --- a/doc/SystemTap_Beginners_Guide/syncandbuild.sh +++ /dev/null @@ -1,38 +0,0 @@ -#!/bin/bash -# Instead of running the original makefile to build the document, run this script instead -echo -n "Please specify your build target (e.g. html, pdf, or html-single) " -read TARG -echo -n "Please specify the product you are building for (enter 1 for Fedora, 2 for RHEL) " -read PROD -#echo -n "Please specify any build parameters you'd like to use (skip this step for none). " -#read PARM -#copy scripts from testsuite -cp -a ../../testsuite en-US/extras/; - -if [ $PROD = 1 ]; -then - sed -i -e 's/<productname>Red Hat Enterprise Linux/<productname>Fedora/g' en-US/Book_Info.xml; - sed -i -e 's/<productnumber>5.4/<productnumber>10/g' en-US/Book_Info.xml; - sed -i -e 's/brand: RedHat/brand: fedora/g' publican.cfg; - sed -i -e 's/condition: RedHat/condition: fedora/g' publican.cfg; - publican build --formats=$TARG --langs=en-US; -# rm -rf en-US/extras/testsuite - sed -i -e 's/<productname>Fedora/<productname>Red Hat Enterprise Linux/g' en-US/Book_Info.xml; - sed -i -e 's/<productnumber>10/<productnumber>5.4/g' en-US/Book_Info.xml; - - -else -sed -i -e 's/brand: fedora/brand: RedHat/g' publican.cfg; -sed -i -e 's/brand: fedora/brand: RedHat/g' publican.cfg; -#make post $PARM $TARG-en-US -publican build --formats=$TARG --langs=en-US; -#rm -rf en-US/extras/testsuite -sed -i -e 's/<productname>Fedora/<productname>Red Hat Enterprise Linux/g' en-US/Book_Info.xml; -sed -i -e 's/<productnumber>10/<productnumber>5.4/g' en-US/Book_Info.xml; - -fi - -echo "done." -echo "Cleaning sync'd files..." -rm -rf en-US/extras/testsuite ; -echo "...done."
\ No newline at end of file diff --git a/doc/SystemTap_Tapset_Reference/Makefile.in b/doc/SystemTap_Tapset_Reference/Makefile.in index 158c9b6b..cb5002ae 100644 --- a/doc/SystemTap_Tapset_Reference/Makefile.in +++ b/doc/SystemTap_Tapset_Reference/Makefile.in @@ -125,6 +125,7 @@ PIECFLAGS = @PIECFLAGS@ PIECXXFLAGS = @PIECXXFLAGS@ PIELDFLAGS = @PIELDFLAGS@ PKG_CONFIG = @PKG_CONFIG@ +PUBLICAN_BRAND = @PUBLICAN_BRAND@ RANLIB = @RANLIB@ RPM_CFLAGS = @RPM_CFLAGS@ RPM_LIBS = @RPM_LIBS@ @@ -160,6 +161,7 @@ have_dvips = @have_dvips@ have_latex = @have_latex@ have_latex2html = @have_latex2html@ have_ps2pdf = @have_ps2pdf@ +have_publican = @have_publican@ have_xmlto = @have_xmlto@ host_alias = @host_alias@ htmldir = @htmldir@ diff --git a/doc/beginners/Makefile.am b/doc/beginners/Makefile.am new file mode 100644 index 00000000..29ffeaba --- /dev/null +++ b/doc/beginners/Makefile.am @@ -0,0 +1,48 @@ +# Makefile.am --- automake input file for systemtap tapset reference manual +## process this file with automake to produce Makefile.in + +# publican will create a pdf file and a directory with *.html files, +# a directory called images that contain *.png and *.svg files, a +# Common_Content/images with more *.png and *.svg files and a +# Common_Content/css directory with *.css files. + +DOC_INSTALL_DIR = $(DESTDIR)$(datadir)/doc/systemtap +SBG = SystemTap_Beginners_Guide +BEGIN_INSTALL_DIR = $(DOC_INSTALL_DIR)/$(SBG) + +if BUILD_PUBLICAN +all: $(SBG).pdf $(SBG)/index.html + +$(SBG).pdf: + publican build --formats=pdf --langs=en-US && \ + mv build/en-US/pdf/*$(SBG)*.pdf $(SBG).pdf + +$(SBG)/index.html: + publican build --formats=html --langs=en-US && \ + mv build/en-US/html $(SBG) + +clean-local: + publican clean + rm -f $(SBG).pdf + rm -rf $(SBG) + +install-data-hook: + $(MKDIR_P) $(DOC_INSTALL_DIR) + $(INSTALL_DATA) $(SBG).pdf $(DOC_INSTALL_DIR) + $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG) + $(INSTALL_DATA) $(SBG)/*.html $(DOC_INSTALL_DIR)/$(SBG) + $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/images + $(INSTALL_DATA) $(SBG)/images/*.png $(SBG)/images/*.svg \ + $(DOC_INSTALL_DIR)/$(SBG)/images + $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/css + $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/images + $(INSTALL_DATA) $(SBG)/Common_Content/css/*.css \ + $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/css + $(INSTALL_DATA) $(SBG)/Common_Content/images/*.png \ + $(SBG)/Common_Content/images/*.svg \ + $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/images + +uninstall-local: + rm -f $(DOC_INSTALL_DIR)/$(SBG).pdf + rm -rf $(DOC_INSTALL_DIR)/$(SBG) +endif diff --git a/doc/beginners/Makefile.in b/doc/beginners/Makefile.in new file mode 100644 index 00000000..2bae95f3 --- /dev/null +++ b/doc/beginners/Makefile.in @@ -0,0 +1,408 @@ +# Makefile.in generated by automake 1.11 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# Makefile.am --- automake input file for systemtap tapset reference manual + +# publican will create a pdf file and a directory with *.html files, +# a directory called images that contain *.png and *.svg files, a +# Common_Content/images with more *.png and *.svg files and a +# Common_Content/css directory with *.css files. +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = doc/beginners +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(top_srcdir)/doc/SystemTap_Beginners_Guide/publican.cfg.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = publican.cfg +CONFIG_CLEAN_VPATH_FILES = +AM_V_GEN = $(am__v_GEN_$(V)) +am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY)) +am__v_GEN_0 = @echo " GEN " $@; +AM_V_at = $(am__v_at_$(V)) +am__v_at_ = $(am__v_at_$(AM_DEFAULT_VERBOSITY)) +am__v_at_0 = @ +SOURCES = +DIST_SOURCES = +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DATE = @DATE@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +GREP = @GREP@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MKDIR_P = @MKDIR_P@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PIECFLAGS = @PIECFLAGS@ +PIECXXFLAGS = @PIECXXFLAGS@ +PIELDFLAGS = @PIELDFLAGS@ +PKG_CONFIG = @PKG_CONFIG@ +PUBLICAN_BRAND = @PUBLICAN_BRAND@ +RANLIB = @RANLIB@ +RPM_CFLAGS = @RPM_CFLAGS@ +RPM_LIBS = @RPM_LIBS@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +U = @U@ +VERSION = @VERSION@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +elfutils_abs_srcdir = @elfutils_abs_srcdir@ +exec_prefix = @exec_prefix@ +gtkmm_CFLAGS = @gtkmm_CFLAGS@ +gtkmm_LIBS = @gtkmm_LIBS@ +have_certutil = @have_certutil@ +have_dvips = @have_dvips@ +have_latex = @have_latex@ +have_latex2html = @have_latex2html@ +have_ps2pdf = @have_ps2pdf@ +have_publican = @have_publican@ +have_xmlto = @have_xmlto@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +libglade_CFLAGS = @libglade_CFLAGS@ +libglade_LIBS = @libglade_LIBS@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +nspr_CFLAGS = @nspr_CFLAGS@ +nss_CFLAGS = @nss_CFLAGS@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +rpm_LIBS = @rpm_LIBS@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sqlite3_LIBS = @sqlite3_LIBS@ +srcdir = @srcdir@ +stap_LIBS = @stap_LIBS@ +staplog_CPPFLAGS = @staplog_CPPFLAGS@ +subdirs = @subdirs@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +DOC_INSTALL_DIR = $(DESTDIR)$(datadir)/doc/systemtap +SBG = SystemTap_Beginners_Guide +BEGIN_INSTALL_DIR = $(DOC_INSTALL_DIR)/$(SBG) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/beginners/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/beginners/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): +publican.cfg: $(top_builddir)/config.status $(top_srcdir)/doc/SystemTap_Beginners_Guide/publican.cfg.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile +installdirs: +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +@BUILD_PUBLICAN_FALSE@uninstall-local: +@BUILD_PUBLICAN_FALSE@clean-local: +@BUILD_PUBLICAN_FALSE@install-data-hook: +clean: clean-am + +clean-am: clean-generic clean-local mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: + @$(NORMAL_INSTALL) + $(MAKE) $(AM_MAKEFLAGS) install-data-hook +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-local + +.MAKE: install-am install-data-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-local \ + distclean distclean-generic distdir dvi dvi-am html html-am \ + info info-am install install-am install-data install-data-am \ + install-data-hook install-dvi install-dvi-am install-exec \ + install-exec-am install-html install-html-am install-info \ + install-info-am install-man install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am uninstall uninstall-am uninstall-local + + +@BUILD_PUBLICAN_TRUE@all: $(SBG).pdf $(SBG)/index.html + +@BUILD_PUBLICAN_TRUE@$(SBG).pdf: +@BUILD_PUBLICAN_TRUE@ publican build --formats=pdf --langs=en-US && \ +@BUILD_PUBLICAN_TRUE@ mv build/en-US/pdf/*$(SBG)*.pdf $(SBG).pdf + +@BUILD_PUBLICAN_TRUE@$(SBG)/index.html: +@BUILD_PUBLICAN_TRUE@ publican build --formats=html --langs=en-US && \ +@BUILD_PUBLICAN_TRUE@ mv build/en-US/html $(SBG) + +@BUILD_PUBLICAN_TRUE@clean-local: +@BUILD_PUBLICAN_TRUE@ publican clean +@BUILD_PUBLICAN_TRUE@ rm -f $(SBG).pdf +@BUILD_PUBLICAN_TRUE@ rm -rf $(SBG) + +@BUILD_PUBLICAN_TRUE@install-data-hook: +@BUILD_PUBLICAN_TRUE@ $(MKDIR_P) $(DOC_INSTALL_DIR) +@BUILD_PUBLICAN_TRUE@ $(INSTALL_DATA) $(SBG).pdf $(DOC_INSTALL_DIR) +@BUILD_PUBLICAN_TRUE@ $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG) +@BUILD_PUBLICAN_TRUE@ $(INSTALL_DATA) $(SBG)/*.html $(DOC_INSTALL_DIR)/$(SBG) +@BUILD_PUBLICAN_TRUE@ $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/images +@BUILD_PUBLICAN_TRUE@ $(INSTALL_DATA) $(SBG)/images/*.png $(SBG)/images/*.svg \ +@BUILD_PUBLICAN_TRUE@ $(DOC_INSTALL_DIR)/$(SBG)/images +@BUILD_PUBLICAN_TRUE@ $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/css +@BUILD_PUBLICAN_TRUE@ $(MKDIR_P) $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/images +@BUILD_PUBLICAN_TRUE@ $(INSTALL_DATA) $(SBG)/Common_Content/css/*.css \ +@BUILD_PUBLICAN_TRUE@ $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/css +@BUILD_PUBLICAN_TRUE@ $(INSTALL_DATA) $(SBG)/Common_Content/images/*.png \ +@BUILD_PUBLICAN_TRUE@ $(SBG)/Common_Content/images/*.svg \ +@BUILD_PUBLICAN_TRUE@ $(DOC_INSTALL_DIR)/$(SBG)/Common_Content/images + +@BUILD_PUBLICAN_TRUE@uninstall-local: +@BUILD_PUBLICAN_TRUE@ rm -f $(DOC_INSTALL_DIR)/$(SBG).pdf +@BUILD_PUBLICAN_TRUE@ rm -rf $(DOC_INSTALL_DIR)/$(SBG) + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: |