From owner-freebsd-questions@FreeBSD.ORG Sat Apr 21 06:31:56 2012 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D8C45106564A for ; Sat, 21 Apr 2012 06:31:56 +0000 (UTC) (envelope-from olivares14031@gmail.com) Received: from mail-iy0-f182.google.com (mail-iy0-f182.google.com [209.85.210.182]) by mx1.freebsd.org (Postfix) with ESMTP id 9BD008FC08 for ; Sat, 21 Apr 2012 06:31:56 +0000 (UTC) Received: by iahk25 with SMTP id k25so18629534iah.13 for ; Fri, 20 Apr 2012 23:31:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; bh=a6157BI6eFGNkdSCxpvWtJHbzIsmfuawbzvwITP8Fu8=; b=pgki2woC5XIyPLeuPFC5v0kSdJaMhp/4xwp1srlgPAJyxJibGZsgy46QZFQkaQpoGs CWmhFlfpCgS7tvDgYVnIAEYBWBjhXZEM/TFqVnnzIXcIWqeBcZqiRqxXV+5IfiwsUGw/ GLX2DJj939f5BHJRzFYCPskyrNKd+P239rXydJWV5hiRc0KNDdGtLH5SeimJuuZUXycX B3YDL94bWh6jlcPh0wBJ8GFdFu51qEcYTUbPskPcATnhFyx2tvx2TBVTmaheeHHdJWIX WV00un5ecDEGIXcp/eXu2wJAMY/SmJHoD6au3glzcaQs2SVtiENvmOgs9ngQ/GjQPgiv x85Q== MIME-Version: 1.0 Received: by 10.50.47.232 with SMTP id g8mr1120807ign.18.1334989916249; Fri, 20 Apr 2012 23:31:56 -0700 (PDT) Received: by 10.50.65.72 with HTTP; Fri, 20 Apr 2012 23:31:56 -0700 (PDT) In-Reply-To: <20120421080406.2364338b.freebsd@edvax.de> References: <20120421080406.2364338b.freebsd@edvax.de> Date: Sat, 21 Apr 2012 01:31:56 -0500 Message-ID: From: Antonio Olivares To: Polytropon Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: FreeBSD Questions Subject: Re: find sources to build Handbook and FAQ for FreeBSD? X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 21 Apr 2012 06:31:56 -0000 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 /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 # # $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 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 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