find sources to build Handbook and FAQ for FreeBSD?
Antonio Olivares
olivares14031 at gmail.com
Sat Apr 21 06:31:56 UTC 2012
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
>
>
>> > Some description about the doc tools is in the FreeBSD Documentation Project
>> > 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. If one does a
>> properties on a PDF, we can see maker dvips + ghostscript 8.71. This
>> 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
More information about the freebsd-questions
mailing list