find sources to build Handbook and FAQ for FreeBSD?
Antonio Olivares
olivares14031 at gmail.com
Sat Apr 21 06:44:37 UTC 2012
On Sat, Apr 21, 2012 at 1:31 AM, Antonio Olivares
<olivares14031 at gmail.com> wrote:
> On Sat, Apr 21, 2012 at 1:04 AM, Polytropon <freebsd at edvax.de> wrote:
>> On Sat, 21 Apr 2012 00:50:20 -0500, Antonio Olivares wrote:
>>> On Fri, Apr 20, 2012 at 8:45 PM, Warren Block <wblock at wonkity.com> wrote:
>>> > On Fri, 20 Apr 2012, Antonio Olivares wrote:
>>> >
>>> >> Does anyone know where the source(s) for the FreeBSD Handbook and
>>> >> FreeBSD FAQ are found?
>>> >
>>> >
>>> > SGML source is in /usr/doc/en_US.ISO8859-1/books/handbook/ and
>>> > /usr/doc/en_US.ISO8859-1/books/faq/, or other subdirectories under /usr/doc
>>> > for other languages. There's build infrastructure in /usr/doc/share.
>>>
>>> [olivares at tricorehome ~]$ cd /usr/doc/share
>>> bash: cd: /usr/doc/share: No such file or directory
>>> [olivares at tricorehome ~]$ cd /usr/doc/
>>> bash: cd: /usr/doc/: No such file or directory
>>
>> See the /usr/ports/misc/freebsd-doc* ports. They will install
>> the documentation in a freebsd/ subtree at the obvious location.
>>
>> % ls /usr/local/share/doc/freebsd
>> de@ en@ faq@
>> de_DE.ISO8859-1/ en_US.ISO8859-1/ handbook@
>>
>> As you can see from this example, I have the "en" and "de"
>> languages installed. The articles/ and books/ subtrees will
>> contain the HTML files.
>>
> Is there a way I can modify Makefile to pull in the sources but not
> pull in tetex?
> It will pull in tetex and create conflict with texlive-freebsd ports
> by Romain Tartiere.
>
> tricorehome# cd freebsd-doc-en/
> tricorehome# ls
> Makefile pkg-plist.extras pkg-plist.pdf
> distinfo pkg-plist.html pkg-plist.ps
> pkg-descr pkg-plist.html-common pkg-plist.txt
> pkg-plist.common pkg-plist.html-split
> tricorehome# ls -l
> total 134
> -rw-r--r-- 1 root wheel 3068 Mar 9 00:10 Makefile
> -rw-r--r-- 1 root wheel 150 Mar 9 00:10 distinfo
> -rw-r--r-- 1 root wheel 102 Feb 23 2009 pkg-descr
> -rw-r--r-- 1 root wheel 5496 Oct 16 2011 pkg-plist.common
> -rw-r--r-- 1 root wheel 709 Mar 29 2009 pkg-plist.extras
> -rw-r--r-- 1 root wheel 4124 Aug 29 2011 pkg-plist.html
> -rw-r--r-- 1 root wheel 25433 Jan 15 07:25 pkg-plist.html-common
> -rw-r--r-- 1 root wheel 72199 Mar 6 04:29 pkg-plist.html-split
> -rw-r--r-- 1 root wheel 4053 Aug 29 2011 pkg-plist.pdf
> -rw-r--r-- 1 root wheel 3982 Aug 29 2011 pkg-plist.ps
> -rw-r--r-- 1 root wheel 4181 Aug 29 2011 pkg-plist.txt
> tricorehome# cat Makefile | more
> # New ports collection makefile for: freebsd-doc-en
> # Date created: 13 August 2008
> # Whom: Marc Fonvieille <blackend at FreeBSD.org>
> #
> # $FreeBSD: ports/misc/freebsd-doc-en/Makefile,v 1.46 2012/03/09
> 06:10:59 blackend Exp $
> #
> # Several knobs can be used to select the documentation formats.
> #
> # WITH_HTML_SPLIT allows the build of the "html-split" format:
> # This is the default format, it is the same format used on
> # www.FreeBSD.org. It is a collection of small, linked HTML files
> # (index.html, plus images and secondary files).
> #
> # WITH_HTML allows the build of the "html" format:
> # a single HTML file per document (article.html or book.html, as
> # appropriate, plus images).
> #
> # WITH_PDF allows the build of the "pdf" format:
> # Adobe Portable Document Format, for use with Adobe
> # Acrobat Reader or Ghostscript (article.pdf or book.pdf, as
> # appropriate).
> #
> # WITH_PS allows the build of the "ps" format:
> # Postscript (article.ps or book.ps, as appropriate).
> #
> # WITH_TXT allows the build of the "txt" format:
> # Plain text (article.txt or book.txt, as appropriate).
> #
>
> PORTNAME= freebsd-doc
> PORTVERSION= 20120308
> CATEGORIES= misc docs
> MASTER_SITES= LOCAL/blackend
> PKGNAMEPREFIX?= en-
>
> MAINTAINER= doceng at FreeBSD.org
> COMMENT?= Documentation from the FreeBSD Documentation Project
>
> WRKSRC= ${WRKDIR}/doc
> PLIST_SUB= DOCSDIR=${DOCBASE} \
> DOCLANG=${DOCLANG} \
> DOCLANG_PREFIX=${DOCLANG_PREFIX}
> MAKE_ARGS= FORMATS="${DOCFORMAT}" \
> DOC_LANG="${DOCLANG}" \
> INSTALL_COMPRESSED= \
> DOCDIR=${PREFIX}/${DOCBASE} \
> DOCOWN=${SHAREOWN} \
> DOCGRP=${SHAREGRP}
>
> DOCLANG?= en_US.ISO8859-1
> DOCLANG_PREFIX?= ${DOCLANG:C/_.*$//}
> DOCBASE?= share/doc/freebsd
>
> PLIST= ${WRKDIR}/pkg-plist
>
> OPTIONS= HTML "Single HTML file per document" Off \
> HTML_SPLIT "The default HTML format used on
> www.FreeBSD.org" On \
> PDF "PDF format" On \
> PS "PostScript format" Off \
> TXT "Plain text" Off
>
> .include <bsd.port.pre.mk>
>
> AVAILABLEFORMATS= HTML HTML_SPLIT PDF PS TXT
>
> # if PACKAGE_BUILDING=yes, enable all of $AVAILABLEFORMATS.
> .if defined(PACKAGE_BUILDING)
> .for F in ${AVAILABLEFORMATS}
> WITH_${F}= yes
> .endfor
> .endif
>
> # translate "WITH_FOO=yes" into "DOCFORMAT+=FOO".
> .for F in ${AVAILABLEFORMATS}
> .if defined(WITH_${F}) && !empty(WITH_${F})
> DOCFORMAT+= ${F:L:S,_,-,}
> .endif
> .endfor
>
> # set a default value when DOCFORMAT is empty
> .if empty(DOCFORMAT)
> DOCFORMAT= html-split
> WITH_HTML_SPLIT= yes
> .endif
>
> .if defined(WITH_PDF) || defined(WITH_PS)
> BUILD_DEPENDS= docproj-jadetex>=1.17:${PORTSDIR}/textproc/docproj-jadetex
> .else
> BUILD_DEPENDS= docproj-nojadetex>=1.17:${PORTSDIR}/textproc/docproj-nojadetex
> .endif
>
> MAKE_JOBS_UNSAFE= yes
>
> .for F in ${DOCFORMAT:L}
> PLIST_FORMATS+= ${F:L}
> .endfor
>
> # when html or html-split is defined as the format, add HTML_COMMON.
> .if defined(WITH_HTML) || defined(WITH_HTML_SPLIT)
> PLIST_FORMATS+= html-common
> .endif
>
> # example files, scripts, etc. coming with the doc and common
> # directories for all formats.
> PLIST_FORMATS+= extras common
>
> pre-build:
> ${CAT} ${PLIST_FORMATS:S,^,${.CURDIR}/pkg-plist.,} > ${PLIST}
>
> .include <bsd.port.post.mk>
>
> tricorehome# cat distinfo
> SHA256 (freebsd-doc-20120308.tar.gz) =
> 66c00f28958d54d0d95523341da4084150d91a50a5a933aeb8b6eb6ae485a3ad
> SIZE (freebsd-doc-20120308.tar.gz) = 28375475
>
I have found the sources.
http://ftp.freebsd.org/pub/FreeBSD/ports/local-distfiles/blackend/freebsd-doc-20120308.tar.gz
I have downloaded them, but now I have my hands full :(
The files are in different form, sgml
[olivares at tricorehome ~/tmp/doc/en_US.ISO8859-1/books/handbook]$ ls -l
total 118
drwxr-xr-x 2 olivares olivares 512 Mar 8 15:13 CVS
-rw-r--r-- 1 olivares olivares 12924 Dec 11 12:21 Makefile
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 advanced-networking
-rw-r--r-- 1 olivares olivares 78 Sep 26 1999 appendix.decl
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 audit
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 basics
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 bibliography
-rw-r--r-- 1 olivares olivares 11648 Feb 7 12:33 book.sgml
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 boot
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 bsdinstall
-rw-r--r-- 1 olivares olivares 77 Aug 28 2001 chapter.decl
-rw-r--r-- 1 olivares olivares 2958 Oct 8 2011 chapters.ent
-rw-r--r-- 1 olivares olivares 1220 Aug 5 2005 colophon.sgml
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 config
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 cutting-edge
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 desktop
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 disks
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 dtrace
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 eresources
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 filesystems
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 firewalls
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 geom
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 install
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 introduction
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 jails
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 kernelconfig
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 l10n
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 linuxemu
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 mac
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 mail
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 mirrors
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 multimedia
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 network-servers
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 pgpkeys
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 ports
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 ppp-and-slip
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 preface
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 printing
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 security
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 serialcomms
-rw-r--r-- 1 olivares olivares 4249 Jun 30 2007 txtfiles.ent
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 users
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 vinum
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 virtualization
drwxr-xr-x 3 olivares olivares 512 Mar 8 15:11 x11
Is there a way to convert these to *.tex format? This way I can run
latex on the main tex file and then after creating the bibliography &
the index run dvips and finally ps2pdf on these files to see if I can
create the handbook with the tools available from kertex?
Best Regards and thanks for your responses. I could not have gotten
here without your help.
Antonio
More information about the freebsd-questions
mailing list