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%2BvmPeG62%2BOVyTRcUthAUxC9NTkaw@mail.gmail.com> In-Reply-To: <20120421080406.2364338b.freebsd@edvax.de> 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>
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: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAJ5UdcNENkM837WRQjFMzZ%2BvmPeG62%2BOVyTRcUthAUxC9NTkaw>