 |
| The Complete FreeBSD |
| Modifications to sources |
| $Id: sources.html,v 1.2 2006/02/27 00:17:58 grog Exp $ |
|
|
A surprising amount of time after the initial release of the sources to “The Complete
FreeBSD”, I discovered some problems that effectively meant that you can't do anything
with them. All of these problems were fixed by 01:00 UTC on 25 February 2006; if you downloaded
after that, you don't need to worry about them.
Missing tools directory
The original version of the sources did not include the tools, so
it's effectively useless. Sorry about that. I've updated the archive, and it now includes the
tools.
If you've already downloaded the source, you just need to download the tools directory, which is much smaller (only 270 kB). Note that the
tools and sources are supposed to be in the same hierarchy:
drwxr-xr-x 6 grog lemis 4096 Feb 25 10:31 Book
drwxr-xr-x 2 grog lemis 1536 Feb 17 09:09 tools
If you have the old sources, first create the Book directory and unpack the old source
into them. Then cd to the parent directory and extract the tools archive, which will
unpack into the directory tools. If you use the new source archive, it will extract into
the directories Book and tools.
Makefile bug
The Makefile supplied in the first version also needs fixing:
--- Book/Makefile 2006/02/23 23:16:43 2.47
+++ Book/Makefile 2006/02/25 00:27:53
@@ -1,7 +1,7 @@
# Makefile for "The Complete FreeBSD" and related documents.
# Greg Lehey, LEMIS
#
-# $Id: sources.html,v 1.2 2006/02/27 00:17:58 grog Exp $
+# $Id: sources.html,v 1.2 2006/02/27 00:17:58 grog Exp $
#
# XXX while this is in the wrong place
@@ -124,7 +124,7 @@
APPENDICES = ${APPENDICES.${SIZE}}
DIRECTORIES = ${SIZE} ${SIZE} ${SIZE}/Toc ${SIZE}/txt ${SIZE}/ps \
- ${SIZE}/nps ${SIZE}/pdf ${SIZE}/roff
+ ${SIZE}/nps ${SIZE}/pdf ${SIZE}/roff ctoc
# The final documents
PSDOCS = ${SIZE}/chapters.ps ${SIZE}/appendix.ps ${SIZE}/ps/toc.ps
@@ -156,7 +156,7 @@
RCS-FILES = ${PREFACE} ${SOURCES} Makefile makebookmakefile paths.make tidy.el grog.mm \
merge getch filter getchapternumbers freebie.sty title.${SIZE} \
makeshortsect makebisdnsect makenetworksect makelongsect makesect errata \
- mkpackages mkpackages-sorted todo backcover mkthumbnail INDEX \
+ mkpackages mkpackages-sorted todo backcover mkthumbnail \
mkids global.mm reset.mm dear-reviewer-1 dear-reviewer-2 strip2nl howto.image README \
errata.mm errata.html textintro.mm mkctoc
@@ -189,7 +189,7 @@
# These targets build the complete book
# Main entry. Make the PDF version of the book.
-all ${SIZE}/book.pdf: ${SIZE}/book.ps
+all ${SIZE}/book.pdf: ${DIRECTORIES} ${SIZE}/book.ps
ps2pdf ${SIZE}/book.ps ${SIZE}/book.pdf
# Build the book in PostScript form
@@ -408,7 +408,7 @@
packages.mm:: packages_body.mm packages_body_sorted.mm
-packages_body.mm: mkpackages INDEX
+packages_body.mm: mkpackages
mkpackages
packages_body_sorted.mm: mkpackages-sorted
@@ -904,7 +904,7 @@
# co -M -q paths.make; \
# fi
-${DIRECTORIES} fmt/exlist fmt/figlist fmt/index fmt/tablist fmt/toc ${SIZE}/pdf ctoc:
+${DIRECTORIES} fmt/exlist fmt/figlist fmt/index fmt/tablist fmt/toc ${SIZE}/pdf:
@echo +++ Creating $@
mkdir -p $@
Check that you have version 2.48 or later of Makefile.
$Id: sources.html,v 1.2 2006/02/27 00:17:58 grog Exp $