Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 21 Apr 2012 01:31:56 -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:  <CAJ5UdcNENkM837WRQjFMzZ+vmPeG62+OVyTRcUthAUxC9NTkaw@mail.gmail.com>
In-Reply-To: <20120421080406.2364338b.freebsd@edvax.de>
References:  <CAJ5UdcOfKT0A2zNDZFqxVyG9wU+5MSgDF6WoB1BPx3zHdfYc1Q@mail.gmail.com> <alpine.BSF.2.00.1204201935460.54561@wonkity.com> <CAJ5UdcP5yHqwLWkOHv=hbDu8jAg21F+7j6BvV=yuv9tgY-=nCQ@mail.gmail.com> <20120421080406.2364338b.freebsd@edvax.de>

Next in thread | Previous in thread | Raw E-Mail | Index | Archive | Help
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> 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 /us=
r/doc
>> > for other languages. =A0There's build infrastructure in /usr/doc/share=
.
>>
>> [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		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@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=3D       freebsd-doc
PORTVERSION=3D    20120308
CATEGORIES=3D     misc docs
MASTER_SITES=3D   LOCAL/blackend
PKGNAMEPREFIX?=3D en-

MAINTAINER=3D     doceng@FreeBSD.org
COMMENT?=3D       Documentation from the FreeBSD Documentation Project

WRKSRC=3D         ${WRKDIR}/doc
PLIST_SUB=3D      DOCSDIR=3D${DOCBASE} \
                DOCLANG=3D${DOCLANG} \
                DOCLANG_PREFIX=3D${DOCLANG_PREFIX}
MAKE_ARGS=3D      FORMATS=3D"${DOCFORMAT}" \
                DOC_LANG=3D"${DOCLANG}" \
                INSTALL_COMPRESSED=3D \
                DOCDIR=3D${PREFIX}/${DOCBASE} \
                DOCOWN=3D${SHAREOWN} \
                DOCGRP=3D${SHAREGRP}

DOCLANG?=3D               en_US.ISO8859-1
DOCLANG_PREFIX?=3D        ${DOCLANG:C/_.*$//}
DOCBASE?=3D               share/doc/freebsd

PLIST=3D          ${WRKDIR}/pkg-plist

OPTIONS=3D        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=3D       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              yes
.endfor
.endif

# translate "WITH_FOO=3Dyes" into "DOCFORMAT+=3DFOO".
.for F in ${AVAILABLEFORMATS}
.if defined(WITH_${F}) && !empty(WITH_${F})
DOCFORMAT+=3D     ${F:L:S,_,-,}
.endif
.endfor

# set a default value when DOCFORMAT is empty
.if empty(DOCFORMAT)
DOCFORMAT=3D              html-split
WITH_HTML_SPLIT=3D        yes
.endif

.if defined(WITH_PDF) || defined(WITH_PS)
BUILD_DEPENDS=3D  docproj-jadetex>=3D1.17:${PORTSDIR}/textproc/docproj-jade=
tex
.else
BUILD_DEPENDS=3D  docproj-nojadetex>=3D1.17:${PORTSDIR}/textproc/docproj-no=
jadetex
.endif

MAKE_JOBS_UNSAFE=3D       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:
        ${CAT} ${PLIST_FORMATS:S,^,${.CURDIR}/pkg-plist.,} > ${PLIST}

.include <bsd.port.post.mk>

tricorehome# cat distinfo
SHA256 (freebsd-doc-20120308.tar.gz) =3D
66c00f28958d54d0d95523341da4084150d91a50a5a933aeb8b6eb6ae485a3ad
SIZE (freebsd-doc-20120308.tar.gz) =3D 28375475

>
>
>> > Some description about the doc tools is in the FreeBSD Documentation P=
roject
>> > Primer at
>> > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html
>>
>> Thanks, but I am looking for \TeX{}/\LaTeX{} source files that are
>> used to build the *.pdf versions of HANDBOOK, & FAQ. =A0If one does a
>> properties on a PDF, we can see maker dvips + ghostscript 8.71. =A0This
>> is what I am looking for, the files to produce that document[sources
>> in tex/latex form] and see if I can produce it with what is readily
>> available in kertex now.
>>
>> If I look in /usr/local/share/doc, these are not there either
>
> I think that's because of the move of documentation out of the
> base system, into separate ports for the supported languages.
>
> SGML source files are in /usr/src/release/doc (part of
> the system sources).
>
>
> --
> Polytropon
> Magdeburg, Germany
> Happy FreeBSD user since 4.0
> Andra moi ennepe, Mousa, ...

Best Regards.


Antonio



Want to link to this message? Use this URL: <http://docs.FreeBSD.org/cgi/mid.cgi?CAJ5UdcNENkM837WRQjFMzZ+vmPeG62+OVyTRcUthAUxC9NTkaw>