Re: find sources to build Handbook and FAQ for FreeBSD?
Antonio Olivares writes: > Does anyone know where the source(s) for the FreeBSD Handbook and > FreeBSD FAQ are found? The best approach for you is probably the supfile in /usr/share/examples/cvsup/doc-supfile Which is documented in the in the fdp-primer, the FreeBSD Handbook... ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
Re: find sources to build Handbook and FAQ for FreeBSD?
On Sat, 21 Apr 2012, Polytropon wrote: On Sat, 21 Apr 2012 00:50:20 -0500, Antonio Olivares wrote: On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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. % 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. These are ported versions (snapshots). The live doc source is in CVS and can be fetched with csup.___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
Re: find sources to build Handbook and FAQ for FreeBSD?
On Sat, 21 Apr 2012, Antonio Olivares wrote:
On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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
You'll have to csup them. See /usr/share/examples/cvsup/doc-supfile.
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.
The SGML source can be rendered several ways. One of those ways uses
Jade to render a TeX version that is then used to render the PDF.
# cd /usr/doc/en_US.ISO8859-1/books/handbook/
# make book.tex___
freebsd-questions@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
Re: find sources to build Handbook and FAQ for FreeBSD?
On Sat, Apr 21, 2012 at 1:31 AM, Antonio Olivares
wrote:
> On Sat, Apr 21, 2012 at 1:04 AM, Polytropon wrote:
>> On Sat, 21 Apr 2012 00:50:20 -0500, Antonio Olivares wrote:
>>> On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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.
>>
>> % 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
> #
> # $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= doc...@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
>
> AVAILABLEFORMATS= HTML HTML_SPLIT PDF PS TXT
>
> # if PACKAGE_BUILDING=yes, enable all of $AVAILABLEFORMATS.
> .if defined(PACKAGE_BUILDING)
> .for F in ${AVAILABLEFORMATS}
>
Re: find sources to build Handbook and FAQ for FreeBSD?
On Sat, Apr 21, 2012 at 1:04 AM, Polytropon wrote:
> On Sat, 21 Apr 2012 00:50:20 -0500, Antonio Olivares wrote:
>> On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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.
>
> % 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
Makefilepkg-plist.extraspkg-plist.pdf
distinfopkg-plist.html pkg-plist.ps
pkg-descr pkg-plist.html-common pkg-plist.txt
pkg-plist.commonpkg-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 wheel150 Mar 9 00:10 distinfo
-rw-r--r-- 1 root wheel102 Feb 23 2009 pkg-descr
-rw-r--r-- 1 root wheel 5496 Oct 16 2011 pkg-plist.common
-rw-r--r-- 1 root wheel709 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
#
# $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= doc...@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
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 e
Re: find sources to build Handbook and FAQ for FreeBSD?
On Sat, 21 Apr 2012 00:50:20 -0500, Antonio Olivares wrote:
> On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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.
% 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.
> > 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, ...
___
freebsd-questions@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
Re: find sources to build Handbook and FAQ for FreeBSD?
On Fri, Apr 20, 2012 at 8:45 PM, Warren Block 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@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
>
> 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
[olivares@tricorehome /usr/local/share]$ cd doc/
[olivares@tricorehome /usr/local/share/doc]$ ls
ImageMagick graphvizneon
NVIDIA_GLX-1.0 gsf netpbm
OpenEXR gsfonts nettle
OpenSP hal-0.5.14 ntp
Terminalhtml2text open-motif
Thunar icedtea-web orage
Xaw3d inputproto pcre
automakeja pdfjam
bashjasper pdflib
bigreqsprotojbigpeps-2.0
bitstream-vera jpegpkg-config
cdrtoolslamepkgtools
check-0.9.8 lcmspoppler
cmake lcms2 py-gtk
compositeproto libFS py-iniparse
cppunit libICE py-libxml2
cupslibXaw py-lxml
curllibXmu pygobject
cvsps libXrender randrproto
damageproto libXvMC rar
db41liba52 rarian
db42libao renderproto
dbus-glib libasprintf ristretto
dejavu libcaca rsvg-2.0
djvulibre libdaemon rsync
dmidecode libdv rtmpdump
docbook libevdocument ruby18
docbook-xml libevview sdl
docbook-xsl libexecinfo setuptools
dvd+rw-toolslibexif snmp
dvdauthor libgcrypt sqlite3
encalibgda subversion
evince libgpg-errort1lib
exo libgphoto2 texi2html
ffmpeg libgphoto2_port thunar-vfs
figlet libiconvtidy
fixesproto libidn tiff
flaclibkate transcode
fluxbox libmpeg2ttfm
fontconfig libnautilus-extension twolame
fontsproto libogg type1inst
frei0r libsigc++-2.0 unique
fusefs libsndfile unrar
gcr-0 libtasn1unzip
gd libtextcat v4l_compat
getopt libvorbis vigra
gettext libwmf wmicons
ghostscript9libwps x48
giflib libxcb xfce-utils
gkrellm libxklavier xfce4-panel
gnome-keyring lua51 xfce4-session
gnuplot lxdvdripxfdesktop
gnutls lzo2xfwm4
goffice-0.8 mdbtoolsxmlcatmgr
gp11mpfrxorg-docs
gperf nasmxtrans
[olivares@tricorehome /usr/local/share/doc]$
Best Regards,
Antonio
___
freebsd-questions@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
Re: find sources to build Handbook and FAQ for FreeBSD?
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. 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 ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"
