Date: Sat, 21 Apr 2012 01:44:36 -0500 From: Antonio Olivares <olivares14031@gmail.com> To: Polytropon <freebsd@edvax.de> Cc: FreeBSD Questions <freebsd-questions@freebsd.org> Subject: Re: find sources to build Handbook and FAQ for FreeBSD? Message-ID: <CAJ5UdcPgEdXfh6qM8Nrs6bYNBPLhREE05=ASra6%2BQ==WHvXD-g@mail.gmail.com> In-Reply-To: <CAJ5UdcNENkM837WRQjFMzZ%2BvmPeG62%2BOVyTRcUthAUxC9NTkaw@mail.gmail.com> References: <CAJ5UdcOfKT0A2zNDZFqxVyG9wU%2B5MSgDF6WoB1BPx3zHdfYc1Q@mail.gmail.com> <alpine.BSF.2.00.1204201935460.54561@wonkity.com> <CAJ5UdcP5yHqwLWkOHv=hbDu8jAg21F%2B7j6BvV=yuv9tgY-=nCQ@mail.gmail.com> <20120421080406.2364338b.freebsd@edvax.de> <CAJ5UdcNENkM837WRQjFMzZ%2BvmPeG62%2BOVyTRcUthAUxC9NTkaw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Apr 21, 2012 at 1:31 AM, Antonio Olivares
<olivares14031@gmail.com> wrote:
> On Sat, Apr 21, 2012 at 1:04 AM, Polytropon <freebsd@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@wonkity.com> wrot=
e:
>>> > 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 /u=
sr/doc
>>> > for other languages. =A0There's build infrastructure in /usr/doc/shar=
e.
>>>
>>> [olivares@tricorehome ~]$ cd /usr/doc/share
>>> bash: cd: /usr/doc/share: No such file or directory
>>> [olivares@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.
>>
>> =A0 =A0 =A0 =A0% ls /usr/local/share/doc/freebsd
>> =A0 =A0 =A0 =A0de@ =A0 =A0 =A0 =A0 =A0 =A0 =A0en@ =A0 =A0 =A0 =A0 =A0 =
=A0 =A0faq@
>> =A0 =A0 =A0 =A0de_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 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0pkg-plist.extras =A0 =A0 =A0 =A0p=
kg-plist.pdf
> distinfo =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0pkg-plist.html =A0 =A0 =A0 =A0 =
=A0pkg-plist.ps
> pkg-descr =A0 =A0 =A0 =A0 =A0 =A0 =A0 pkg-plist.html-common =A0 pkg-plist=
.txt
> pkg-plist.common =A0 =A0 =A0 =A0pkg-plist.html-split
> tricorehome# ls -l
> total 134
> -rw-r--r-- =A01 root =A0wheel =A0 3068 Mar =A09 00:10 Makefile
> -rw-r--r-- =A01 root =A0wheel =A0 =A0150 Mar =A09 00:10 distinfo
> -rw-r--r-- =A01 root =A0wheel =A0 =A0102 Feb 23 =A02009 pkg-descr
> -rw-r--r-- =A01 root =A0wheel =A0 5496 Oct 16 =A02011 pkg-plist.common
> -rw-r--r-- =A01 root =A0wheel =A0 =A0709 Mar 29 =A02009 pkg-plist.extras
> -rw-r--r-- =A01 root =A0wheel =A0 4124 Aug 29 =A02011 pkg-plist.html
> -rw-r--r-- =A01 root =A0wheel =A025433 Jan 15 07:25 pkg-plist.html-common
> -rw-r--r-- =A01 root =A0wheel =A072199 Mar =A06 04:29 pkg-plist.html-spli=
t
> -rw-r--r-- =A01 root =A0wheel =A0 4053 Aug 29 =A02011 pkg-plist.pdf
> -rw-r--r-- =A01 root =A0wheel =A0 3982 Aug 29 =A02011 pkg-plist.ps
> -rw-r--r-- =A01 root =A0wheel =A0 4181 Aug 29 =A02011 pkg-plist.txt
> tricorehome# cat Makefile | more
> # New ports collection makefile for: =A0 =A0freebsd-doc-en
> # Date created: =A0 =A0 =A0 =A0 13 August 2008
> # Whom: =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 Marc Fonvieille <blackend@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. =A0It 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=3D =A0 =A0 =A0 freebsd-doc
> PORTVERSION=3D =A0 =A020120308
> CATEGORIES=3D =A0 =A0 misc docs
> MASTER_SITES=3D =A0 LOCAL/blackend
> PKGNAMEPREFIX?=3D en-
>
> MAINTAINER=3D =A0 =A0 doceng@FreeBSD.org
> COMMENT?=3D =A0 =A0 =A0 Documentation from the FreeBSD Documentation Proj=
ect
>
> WRKSRC=3D =A0 =A0 =A0 =A0 ${WRKDIR}/doc
> PLIST_SUB=3D =A0 =A0 =A0DOCSDIR=3D${DOCBASE} \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOCLANG=3D${DOCLANG} \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOCLANG_PREFIX=3D${DOCLANG_PREFIX}
> MAKE_ARGS=3D =A0 =A0 =A0FORMATS=3D"${DOCFORMAT}" \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOC_LANG=3D"${DOCLANG}" \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0INSTALL_COMPRESSED=3D \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOCDIR=3D${PREFIX}/${DOCBASE} \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOCOWN=3D${SHAREOWN} \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0DOCGRP=3D${SHAREGRP}
>
> DOCLANG?=3D =A0 =A0 =A0 =A0 =A0 =A0 =A0 en_US.ISO8859-1
> DOCLANG_PREFIX?=3D =A0 =A0 =A0 =A0${DOCLANG:C/_.*$//}
> DOCBASE?=3D =A0 =A0 =A0 =A0 =A0 =A0 =A0 share/doc/freebsd
>
> PLIST=3D =A0 =A0 =A0 =A0 =A0${WRKDIR}/pkg-plist
>
> OPTIONS=3D =A0 =A0 =A0 =A0HTML =A0 =A0 =A0 =A0 =A0 =A0"Single HTML file p=
er document" Off \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0HTML_SPLIT =A0 =A0 =A0"The default HTML fo=
rmat used on
> www.FreeBSD.org" On \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0PDF =A0 =A0 =A0 =A0 =A0 =A0 "PDF format" O=
n \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0PS =A0 =A0 =A0 =A0 =A0 =A0 =A0"PostScript =
format" Off \
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0TXT =A0 =A0 =A0 =A0 =A0 =A0 "Plain text" O=
ff
>
> .include <bsd.port.pre.mk>
>
> AVAILABLEFORMATS=3D =A0 =A0 =A0 HTML HTML_SPLIT PDF PS TXT
>
> # if PACKAGE_BUILDING=3Dyes, enable all of $AVAILABLEFORMATS.
> .if defined(PACKAGE_BUILDING)
> .for F in ${AVAILABLEFORMATS}
> WITH_${F}=3D =A0 =A0 =A0 =A0 =A0 =A0 =A0yes
> .endfor
> .endif
>
> # translate "WITH_FOO=3Dyes" into "DOCFORMAT+=3DFOO".
> .for F in ${AVAILABLEFORMATS}
> .if defined(WITH_${F}) && !empty(WITH_${F})
> DOCFORMAT+=3D =A0 =A0 ${F:L:S,_,-,}
> .endif
> .endfor
>
> # set a default value when DOCFORMAT is empty
> .if empty(DOCFORMAT)
> DOCFORMAT=3D =A0 =A0 =A0 =A0 =A0 =A0 =A0html-split
> WITH_HTML_SPLIT=3D =A0 =A0 =A0 =A0yes
> .endif
>
> .if defined(WITH_PDF) || defined(WITH_PS)
> BUILD_DEPENDS=3D =A0docproj-jadetex>=3D1.17:${PORTSDIR}/textproc/docproj-=
jadetex
> .else
> BUILD_DEPENDS=3D =A0docproj-nojadetex>=3D1.17:${PORTSDIR}/textproc/docpro=
j-nojadetex
> .endif
>
> MAKE_JOBS_UNSAFE=3D =A0 =A0 =A0 yes
>
> .for F in ${DOCFORMAT:L}
> PLIST_FORMATS+=3D ${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+=3D html-common
> .endif
>
> # example files, scripts, etc. coming with the doc and common
> # directories for all formats.
> PLIST_FORMATS+=3D extras common
>
> pre-build:
> =A0 =A0 =A0 =A0${CAT} ${PLIST_FORMATS:S,^,${.CURDIR}/pkg-plist.,} > ${PLI=
ST}
>
> .include <bsd.port.post.mk>
>
> tricorehome# cat distinfo
> SHA256 (freebsd-doc-20120308.tar.gz) =3D
> 66c00f28958d54d0d95523341da4084150d91a50a5a933aeb8b6eb6ae485a3ad
> SIZE (freebsd-doc-20120308.tar.gz) =3D 28375475
>
I have found the sources.
http://ftp.freebsd.org/pub/FreeBSD/ports/local-distfiles/blackend/freebsd-d=
oc-20120308.tar.gz
I have downloaded them, but now I have my hands full :(
The files are in different form, sgml
[olivares@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAJ5UdcPgEdXfh6qM8Nrs6bYNBPLhREE05=ASra6%2BQ==WHvXD-g>