From owner-freebsd-doc Sun Mar 17 11:35:21 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id LAA00960 for doc-outgoing; Sun, 17 Mar 1996 11:35:21 -0800 (PST) Received: from news1.gtn.com (news1.gtn.com [192.109.159.3]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id LAA00935 Sun, 17 Mar 1996 11:35:12 -0800 (PST) Received: (from uucp@localhost) by news1.gtn.com (8.7.2/8.7.2) id UAA25016; Sun, 17 Mar 1996 20:15:29 +0100 (MET) Received: (from andreas@localhost) by knobel.gun.de (8.7.5/8.7.3) id UAA09099; Sun, 17 Mar 1996 20:11:08 +0100 (MET) From: Andreas Klemm Message-Id: <199603171911.UAA09099@knobel.gun.de> Subject: HOWTO make a FreeBSD port To: doc@freebsd.org Date: Sun, 17 Mar 1996 20:11:08 +0100 (MET) Cc: ports@freebsd.org X-Mailer: ELM [version 2.4ME+ PL13 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi ! I've tried to make a little guide how to create a port. Ok, it still doesn't cover every detail, but is perhaps a good guidance for the "very beginner". Please could someone, who is experienced in writing smgl documents, convert this into sgml (if you like this document) ? I think it should be included into the FreeBSD Handbook in the ports section as an "life" example. Additionally you native English speakers should correct a bit my chicken English if needed ;-)) BTW: Satoshi, a new port is coming, guess what ;-)) Regards Andreas /// ======================================================================= From: Andreas Klemm How to create a FreeBSD port Let's say we want to create a port of the program mapedit, that is heavily used by WEB authors to create clickable image maps. In the first step we create a new directory in the ports directory structure, where all port files will reside: # mkdir -p /usr/ports/www/mapedit In the first step we'll create a small and simple Makefile with a minimum configuration. The first aim is to automatically get the source archive from the ftp server. After that we'll find out step for step, which additional thinks we have do define there. The starting Makefile contains only four lines: -------------------------------------------------------------------------------- DISTNAME= mapedit1.5 CATEGORIES= www MASTER_SITES= ftp://ftp.boutell.com/pub/boutell/mapedit/ .include -------------------------------------------------------------------------------- When choosing a DISTNAME it's a good starting point, to take the name of the source archive, since many other variables and assumptions in the bsd.port.mk file are based on that name. The name of the tar archive we want to get is mapedit1.5.tar.Z. Therefore we choose the distname mapedit1.5. Let's type 'make extract' at the command prompt to get and extract the sources and see what's happening: # make extract >> mapedit1.5.tar.gz doesn't seem to exist on this system. >> Attempting to fetch from ftp://ftp.boutell.com/pub/boutell/mapedit/. Not bad. Make detected, that mapedit1.5.tar.Z isn't stored in /usr/ports/distfiles and automtically tries to get the file via ftp from the master site. The only thing we have to manage now is, that we have to change the suffix ".tar.gz" since our source isn't compressed with GNU zip. When browsing through /usr/share/mk/bsd.port.mk we see the following definition: DISTFILES - Name(s) of archive file(s) containing distribution (default: ${DISTNAME}${EXTRACT_SUFX}). This means, that we have to change the variable EXTRACT_SUFX, to get the ftp part managed, Makefile now looks like this: ------------------------------------------------------------------------------- DISTNAME= mapedit1.5 CATEGORIES= www EXTRACT_SUFX= .tar.Z MASTER_SITES= ftp://ftp.boutell.com/pub/boutell/mapedit/ .include ------------------------------------------------------------------------------- Let's see what's happening now: # make extract ------------------------------------------------------------------------------- 1 >> mapedit1.5.tar.Z doesn't seem to exist on this system. 2 >> Attempting to fetch from ftp://ftp.boutell.com/pub/boutell/mapedit/. 3 Receiving file: mapedit1.5.tar.Z 4 100% 0 71407 bytes. ETA: 0:00 5 mapedit1.5.tar.Z: 71407 bytes received in 49.25 seconds, 1.42 K/s. 6 >> No MD5 checksum file. 7 ===> Extracting for mapedit1.5 ------------------------------------------------------------------------------- This looks better. Line 1 shows, that ncftp now tries to get the correct file from the ftp server. The transmission went on without any error (lines 3-5). Line 6 is normal. We'll create a md5 file later. This file will then reside in the files subdir. Line 7 informs us, that the tar archive was automatically extracted in the subdir 'work'. After the transmission (lines 1-5) we have now the source archive locally stored on disk: /usr/ports/distfiles/mapedit1.5.tar.Z After the extraction of the sources (line 7) we have a workdir /usr/ports/www/mapedit/work/mapedit1.5 The toplevel directory of the workdir shows us, that this is an X11 program. By defining USE_IMAKE and USE_X11 in the Makefile, we achieve, that imake will be started up automatically before the compilation of the sources (in the workdir) starts. Makefile looks now like that: -------------------------------------------------------------------------------- DISTNAME= mapedit1.5 CATEGORIES+= www EXTRACT_SUFX= .tar.Z USE_IMAKE= True USE_X11= True MASTER_SITES= ftp://ftp.boutell.com/pub/boutell/mapedit/ .include -------------------------------------------------------------------------------- If we type 'make' again in the port toplevel directory (/usr/ports/www/mapedit), we'll notice that make is clever and remembers, that the source is already here, and that it was extrected in a previous step. This is done by 0 Byte file in the workdir, that act as a marker. In this case the file /usr/ports/www/mapedit1.5/work/.extract_done prevents a new extraction. # make -------------------------------------------------------------------------------- 1 >> No MD5 checksum file. 2 ===> Patching for mapedit1.5 3 ===> Configuring for mapedit1.5 4 mv -f Makefile Makefile.bak 5 imake -DUseInstalled -I/usr/X11R6/lib/X11/config 6 make Makefiles 7 make includes 8 make depend 9 gccmakedep -- -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -- gd.c mapedit.c 10 In file included from gd.c:1: 11 /usr/include/malloc.h:2: warning: #warning "this file includes which is obsoleted, use instead" -------------------------------------------------------------------------------- As we can see in line 5, imake was now properly called, before starting the compilation, that would have started after the 'make depend'. The error message informs us now, that we should make some modification to the sources, since FreeBSD prefers the header file . This will be a good example, how we add patches to this port. So that even the patching of the sources is done automatically by make. All we have to do is to change the sources in the workdir, make context diffs and place them into a subdir called patches. # grep malloc work/mapedit1.5/* work/mapedit1.5/gd.c:#include work/mapedit1.5/mapedit.c:#include Save the files you want to modify later # cp work/mapedit1.5/gd.c work/mapedit1.5/gd.c.orig # cp work/mapedit1.5/mapedit.c work/mapedit1.5/mapedit.c.orig Modify the files # vi `grep -l malloc work/mapedit1.5/*` For example: #ifdef __FreeBSD__ #include #else #include #endif Create the directory for the patches, and collect the context diffs: # mkdir /usr/ports/www/mapedit/patches You have to stay in the workdir directory ! # cd /usr/ports/www/mapedit/work/mapedit1.5 # diff -c gd.c.orig gd.c.orig > ../../patches/patch-aa # diff -c mapedit.c.orig mapedit.c.orig > ../../patches/patch-ab Now we want to test, if everything runs fine, including this new patch feature: # cd ../.. # topdir of the port /usr/port/www/mapedit # make clean -------------------------------------------------------------------------------- ===> Cleaning for mapedit1.5 -------------------------------------------------------------------------------- Please note, doing a make clean removes the whole work directory ! At this point we'll create a checksum file (md5 file), so this step is done, too. # make makesum This creates a md5 file in /usr/ports/www/mapedit/files/md5 with the following content: MD5 (mapedit1.5.tar.Z) = 7ad4bd45951dc2e07bad032379e96ed2 This makes sure, that people using your port, have grabbed the correct source archive and that it's not corrupt. Again we start the port by typing simply 'make' # make -------------------------------------------------------------------------------- 1 Checksums OK. 2 ===> Extracting for mapedit1.5 3 ===> Patching for mapedit1.5 4 ===> Applying FreeBSD patches for mapedit1.5 5 ===> Configuring for mapedit1.5 6 mv -f Makefile Makefile.bak 7 imake -DUseInstalled -I/usr/X11R6/lib/X11/config 8 make Makefiles 9 make includes 10 make depend 11 gccmakedep -- -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -- gd.c mapedit.c 12 ===> Building for mapedit1.5 13 gcc -m486 -O2 -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -c gd.c 14 gcc -m486 -O2 -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -c mapedit.c 15 rm -f mapedit 16 gcc -o mapedit -m486 -O2 -L/usr/X11R6/lib gd.o mapedit.o -lXaw -lXmu -L/usr/X11R6/lib -lXt -lX11 -lXt -lSM -lICE -lXExExt -lXext -lX11 -lm -------------------------------------------------------------------------------- What's new ? After creating the md5 file, we'll get informed now, that we got the correct sources and that they aren't coruppted (line 1) In the following we see a successfully running port. We are now ready to install the package by simply typing # make install -------------------------------------------------------------------------------- Checksums OK. ===> Installing for mapedit1.5 /usr/bin/install -c -s mapedit /usr/X11R6/bin/mapedit install in . done make: don't know how to make mapedit.man. Stop *** Error code 2 ... -------------------------------------------------------------------------------- Oh, what happened now ... Well, the package comes without manual page. We have to tell 'make' this circumstance in the Makefile, too, by defining NO_INSTALL_MANPAGES. Makefile now looks like this: -------------------------------------------------------------------------------- DISTNAME= mapedit1.5 CATEGORIES+= www EXTRACT_SUFX= .tar.Z USE_IMAKE= True USE_X11= True NO_INSTALL_MANPAGES= True MASTER_SITES= ftp://ftp.boutell.com/pub/boutell/mapedit/ .include -------------------------------------------------------------------------------- After that modification we repeat the 'make install' step. Now the output is: -------------------------------------------------------------------------------- Checksums OK. ===> Installing for mapedit1.5 /usr/bin/install -c -s mapedit /usr/X11R6/bin/mapedit install in . done ** Missing package files for mapedit1.5 - installation not recorded. *** Error code 1 ... -------------------------------------------------------------------------------- Ok, well done. We only have to create some missing files for package management, so that the package can be recorded properly as installed. This is needed to be able to use the package management utilities like pkg_delete and friends. For this purpose we create the following files in a separate pkg directory: COMMENT a one line description of the package -------------------------------------------------------------------------------- mapedit - a WWW authoring tool to create clickable maps -------------------------------------------------------------------------------- DESCR a short description of the package (a "screen full") -------------------------------------------------------------------------------- mapedit was made for the purpose "blah", etc, etc etc, from foo@bar.com -------------------------------------------------------------------------------- PLIST a list of installed files that belong to the package The PLIST file is hevily used by the package management utilities like pkg_delete. A suitable PLIST file for mapedit would be: -------------------------------------------------------------------------------- /usr/X11R6/bin/mapedit -------------------------------------------------------------------------------- A new test. We hope, it's the final one ;-) # make clean all install -------------------------------------------------------------------------------- ===> Cleaning for mapedit1.5 Checksums OK. ===> Extracting for mapedit1.5 ===> Patching for mapedit1.5 ===> Applying FreeBSD patches for mapedit1.5 ===> Configuring for mapedit1.5 mv -f Makefile Makefile.bak imake -DUseInstalled -I/usr/X11R6/lib/X11/config make Makefiles make includes make depend gccmakedep -- -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -- gd.c mapedit.c ===> Building for mapedit1.5 gcc -m486 -O2 -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -c gd.c gcc -m486 -O2 -I/usr/X11R6/include -DCSRG_BASED -DFUNCPROTO=15 -DNARROWPROTO -DANSI -c mapedit.c rm -f mapedit gcc -o mapedit -m486 -O2 -L/usr/X11R6/lib gd.o mapedit.o -lXaw -lXmu -L/us r/X11R6/lib -lXt -lX11 -lXt -lSM -lICE -lXExExt -lXext -lX11 -lm ===> Installing for mapedit1.5 /usr/bin/install -c -s mapedit /usr/X11R6/bin/mapedit install in . done -------------------------------------------------------------------------------- Ok, well done ! Now we should finally add a note into Makefile, who's the maintainer of this packages. So the very last Makefile looks like this: -------------------------------------------------------------------------------- # New ports collection makefile for: mapedit # Version required: 1.5 # Date created: Sun Mar 17 20:00:31 MET 1996 # Whom: Andreas Klemm # DISTNAME= mapedit1.5 CATEGORIES+= www EXTRACT_SUFX= .tar.Z MAINTAINER= andreas@knobel.gun.de USE_IMAKE= True USE_X11= True NO_INSTALL_MANPAGES= True MASTER_SITES= ftp://ftp.boutell.com/pub/boutell/mapedit/ .include -------------------------------------------------------------------------------- That's it folks. After doing the port you can send it as compressed tar archive uuencoded to the maintainer of the ports collection. # cd /usr/ports/www/mapedit # make clean # cd .. # tar cvzf mapedit.tar.gz mapedit # uuencode mapedit.tar.gz < mapedit.tar.gz > mapedit.tar.gz.uue # mail -s "new port www/mapedit" PortsMaintainer < mapedit.tar.gz.uue This is only an example, normally one has to say some more things about the port ;-) And don't forget to send it as user, not as root ;-)) -- andreas@knobel.gun.de /\/\___ Wiechers & Partner Datentechnik GmbH Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ pgp p-key http://www-swiss.ai.mit.edu/~bal/pks-toplev.html >>> powered by <<< ftp://sunsite.unc.edu/pub/Linux/system/Printing/aps-491.tgz >>> FreeBSD <<< "Ich bleibe bei der Aussage und trotze den Flames. :-)" Ulli Horlacher 02/96 From owner-freebsd-doc Sun Mar 17 12:01:35 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id MAA01953 for doc-outgoing; Sun, 17 Mar 1996 12:01:35 -0800 (PST) Received: from upsmot02.msn.com (upsmot02.msn.com [204.95.110.79]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id MAA01948 for ; Sun, 17 Mar 1996 12:01:34 -0800 (PST) Received: from upmajb02.msn.com (upmajb02.msn.com [204.95.110.74]) by upsmot02.msn.com (8.6.8.1/Configuration 4) with SMTP id MAA26237 for ; Sun, 17 Mar 1996 12:00:00 -0800 Date: Sun, 17 Mar 96 20:00:37 UT From: "Val Vechnyak" Message-Id: To: doc@freebsd.org Subject: handbook Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi, Is there any way to download this handy handbook? val From owner-freebsd-doc Sun Mar 17 13:24:00 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id NAA06817 for doc-outgoing; Sun, 17 Mar 1996 13:24:00 -0800 (PST) Received: from news1.gtn.com (news1.gtn.com [192.109.159.3]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id NAA06807 for ; Sun, 17 Mar 1996 13:23:54 -0800 (PST) Received: (from uucp@localhost) by news1.gtn.com (8.7.2/8.7.2) id WAA14037; Sun, 17 Mar 1996 22:00:26 +0100 (MET) Received: from knobel.gun.de (localhost [127.0.0.1]) by knobel.gun.de (8.7.5/8.7.3) with SMTP id VAA11004; Sun, 17 Mar 1996 21:19:53 +0100 (MET) Date: Sun, 17 Mar 1996 21:19:53 +0100 (MET) From: Andreas Klemm To: "David L. Spencer" cc: doc@freebsd.org Subject: Re: The FreeBSD Handbook In-Reply-To: <199603120927.EAA23471@bronze.interlog.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Tue, 12 Mar 1996, David L. Spencer wrote: > Is it possible to download a complete ASCII version of the online > handbook? Do you mean the FreeBSD handbook ? It's already there ;-) /usr/share/doc/handbook contains both, the html pages and the ascii version: root{1021} /usr/share/doc/handbook ll *.ascii -r--r--r-- 1 bin bin 690288 Mar 14 00:08 handbook.ascii -- andreas@knobel.gun.de /\/\___ Wiechers & Partner Datentechnik GmbH Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ pgp p-key http://www-swiss.ai.mit.edu/~bal/pks-toplev.html >>> powered by <<< ftp://sunsite.unc.edu/pub/Linux/system/Printing/aps-491.tgz >>> FreeBSD <<< "Ich bleibe bei der Aussage und trotze den Flames. :-)" Ulli Horlacher 02/96 From owner-freebsd-doc Sun Mar 17 14:27:33 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id OAA10439 for doc-outgoing; Sun, 17 Mar 1996 14:27:33 -0800 (PST) Received: from sunrise.cs.berkeley.edu (sunrise.CS.Berkeley.EDU [128.32.38.121]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id OAA10434 Sun, 17 Mar 1996 14:27:30 -0800 (PST) Received: (from asami@localhost) by sunrise.cs.berkeley.edu (8.6.12/8.6.12) id OAA18571; Sun, 17 Mar 1996 14:30:00 -0800 Date: Sun, 17 Mar 1996 14:30:00 -0800 Message-Id: <199603172230.OAA18571@sunrise.cs.berkeley.edu> To: andreas@knobel.gun.de CC: doc@freebsd.org, ports@freebsd.org In-reply-to: <199603171911.UAA09099@knobel.gun.de> (message from Andreas Klemm on Sun, 17 Mar 1996 20:11:08 +0100 (MET)) Subject: Re: HOWTO make a FreeBSD port From: asami@cs.berkeley.edu (Satoshi Asami) Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk * I've tried to make a little guide how to create a port. Ok, it still * doesn't cover every detail, but is perhaps a good guidance for the * "very beginner". * * Please could someone, who is experienced in writing smgl documents, * convert this into sgml (if you like this document) ? * * I think it should be included into the FreeBSD Handbook in the * ports section as an "life" example. I'm sorry, but there already is a "how to make a port" in the Handbook. It's buried somewhere in the "how to contribute" section, maybe that's why you didn't see it. Satoshi From owner-freebsd-doc Sun Mar 17 23:17:47 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id XAA04321 for doc-outgoing; Sun, 17 Mar 1996 23:17:47 -0800 (PST) Received: from news1.gtn.com (news1.gtn.com [192.109.159.3]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id XAA04304 Sun, 17 Mar 1996 23:17:42 -0800 (PST) Received: (from uucp@localhost) by news1.gtn.com (8.7.2/8.7.2) id IAA04511; Mon, 18 Mar 1996 08:00:20 +0100 (MET) Received: from knobel.gun.de (localhost [127.0.0.1]) by knobel.gun.de (8.7.5/8.7.3) with SMTP id HAA00356; Mon, 18 Mar 1996 07:47:43 +0100 (MET) Date: Mon, 18 Mar 1996 07:47:42 +0100 (MET) From: Andreas Klemm To: Satoshi Asami cc: doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-Reply-To: <199603172230.OAA18571@sunrise.cs.berkeley.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Sun, 17 Mar 1996, Satoshi Asami wrote: > * I've tried to make a little guide how to create a port. Ok, it still > * doesn't cover every detail, but is perhaps a good guidance for the > * "very beginner". > * > * Please could someone, who is experienced in writing smgl documents, > * convert this into sgml (if you like this document) ? > * > * I think it should be included into the FreeBSD Handbook in the > * ports section as an "life" example. > > I'm sorry, but there already is a "how to make a port" in the > Handbook. It's buried somewhere in the "how to contribute" section, > maybe that's why you didn't see it. Ask Jordan. Some weeks ago he wanted me to write such a very beginner doku. The reason was that he thinks, that the section that is now in the handbook might be too academic "from programmer to programmer". Uhhh.... I hust saw into the handbook, might it be, that this is a new section or that it was rewritten :-( 2 hours for /dev/null, *sigh*, maybe I better had asked before doing the work... But maybe there is demand for something like a "life example" ? -- andreas@knobel.gun.de /\/\___ Wiechers & Partner Datentechnik GmbH Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ pgp p-key http://www-swiss.ai.mit.edu/~bal/pks-toplev.html >>> powered by <<< ftp://sunsite.unc.edu/pub/Linux/system/Printing/aps-491.tgz >>> FreeBSD <<< "Ich bleibe bei der Aussage und trotze den Flames. :-)" Ulli Horlacher 02/96 From owner-freebsd-doc Sun Mar 17 23:28:49 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id XAA04764 for doc-outgoing; Sun, 17 Mar 1996 23:28:49 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id XAA04745 Sun, 17 Mar 1996 23:28:44 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id XAA05161; Sun, 17 Mar 1996 23:28:17 -0800 (PST) To: asami@cs.berkeley.edu (Satoshi Asami) cc: andreas@knobel.gun.de, doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-reply-to: Your message of "Sun, 17 Mar 1996 14:30:00 PST." <199603172230.OAA18571@sunrise.cs.berkeley.edu> Date: Sun, 17 Mar 1996 23:28:17 -0800 Message-ID: <5159.827134097@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Well, not too fast I think - I haven't yet had the chance to read Andreas's little submission in detail (it's in my list of pending things to do) but it may well contain parts which are far superior to the mess that's currently there. I'm confident in saying that the current "how to do a port" document is trash since I wrote quite a bit of it! :-) I've wanted to redo it for some time. Jordan > * I've tried to make a little guide how to create a port. Ok, it still > * doesn't cover every detail, but is perhaps a good guidance for the > * "very beginner". > * > * Please could someone, who is experienced in writing smgl documents, > * convert this into sgml (if you like this document) ? > * > * I think it should be included into the FreeBSD Handbook in the > * ports section as an "life" example. > > I'm sorry, but there already is a "how to make a port" in the > Handbook. It's buried somewhere in the "how to contribute" section, > maybe that's why you didn't see it. > > Satoshi From owner-freebsd-doc Sun Mar 17 23:59:06 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id XAA05833 for doc-outgoing; Sun, 17 Mar 1996 23:59:06 -0800 (PST) Received: from genesis.atrad.adelaide.edu.au (genesis.atrad.adelaide.edu.au [129.127.96.120]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id XAA05803 Sun, 17 Mar 1996 23:58:54 -0800 (PST) Received: from msmith@localhost by genesis.atrad.adelaide.edu.au (8.6.12/8.6.9) id SAA25084; Mon, 18 Mar 1996 18:41:48 +1030 From: Michael Smith Message-Id: <199603180811.SAA25084@genesis.atrad.adelaide.edu.au> Subject: Re: HOWTO make a FreeBSD port To: andreas@knobel.gun.de (Andreas Klemm) Date: Mon, 18 Mar 1996 18:41:47 +1030 (CST) Cc: asami@cs.berkeley.edu, doc@freebsd.org, ports@freebsd.org In-Reply-To: from "Andreas Klemm" at Mar 18, 96 07:47:42 am MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Andreas Klemm stands accused of saying: > > 2 hours for /dev/null, *sigh*, maybe I better had asked before doing > the work... > > But maybe there is demand for something like a "life example" ? Yes! Definitely! Don't even _dream_ of tossing it out; rather, get it added to the section as "Andreas Knobel writes 'This is how I created the XYZ port'" as an example. Very useful! > Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ -- ]] Mike Smith, Software Engineer msmith@atrad.adelaide.edu.au [[ ]] Genesis Software genesis@atrad.adelaide.edu.au [[ ]] High-speed data acquisition and (GSM mobile) 0411-222-496 [[ ]] realtime instrument control (ph/fax) +61-8-267-3039 [[ ]] Collector of old Unix hardware. "Where are your PEZ?" The Tick [[ From owner-freebsd-doc Mon Mar 18 00:03:57 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA06210 for doc-outgoing; Mon, 18 Mar 1996 00:03:57 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA06189 Mon, 18 Mar 1996 00:03:52 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id AAA05313; Mon, 18 Mar 1996 00:03:28 -0800 (PST) To: Andreas Klemm cc: Satoshi Asami , doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-reply-to: Your message of "Mon, 18 Mar 1996 07:47:42 +0100." Date: Mon, 18 Mar 1996 00:03:28 -0800 Message-ID: <5311.827136208@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > Ask Jordan. Some weeks ago he wanted me to write such a very beginner > doku. The reason was that he thinks, that the section that is now > in the handbook might be too academic "from programmer to programmer". Yep. The whole section needs a re-write along the following lines: 1. What is the ports collection? 2. How do I use the ports collection? 3. How do I make a port of my own? 2. How does the ports collcetion work? Jordan From owner-freebsd-doc Mon Mar 18 00:12:17 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA06646 for doc-outgoing; Mon, 18 Mar 1996 00:12:17 -0800 (PST) Received: from silvia.HIP.Berkeley.EDU (silvia.HIP.Berkeley.EDU [136.152.64.181]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA06639 Mon, 18 Mar 1996 00:12:14 -0800 (PST) Received: (from asami@localhost) by silvia.HIP.Berkeley.EDU (8.7.5/8.6.9) id AAA02398; Mon, 18 Mar 1996 00:11:38 -0800 (PST) Date: Mon, 18 Mar 1996 00:11:38 -0800 (PST) Message-Id: <199603180811.AAA02398@silvia.HIP.Berkeley.EDU> To: andreas@knobel.gun.de CC: doc@freebsd.org, ports@freebsd.org In-reply-to: (message from Andreas Klemm on Mon, 18 Mar 1996 07:47:42 +0100 (MET)) Subject: Re: HOWTO make a FreeBSD port From: asami@cs.berkeley.edu (Satoshi Asami) Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk * Ask Jordan. Some weeks ago he wanted me to write such a very beginner : * 2 hours for /dev/null, *sigh*, maybe I better had asked before doing * the work... I wish you'd asked me (the ports manager) before, I have put a large amount of work (measured in days if not weeks) to revitalize that section, and it is quite complete now (I think). * But maybe there is demand for something like a "life example" ? Yes, I'll see if I can put it in there, it can be quite useful. But before, can you please read the relevant section from the most up-to-date handbook (you can get to it from www.freebsd.org) and resubmit your "example"? You'll probably notice that there are quite a few things that need to be changed. :) (I took a look at your submission the first time I saw it, one of the reasons why I was so terse in the first mail was because I knew it needed a big rewrite to even be considered going in there.) Thanks! Satoshi From owner-freebsd-doc Mon Mar 18 00:15:56 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA06856 for doc-outgoing; Mon, 18 Mar 1996 00:15:56 -0800 (PST) Received: from silvia.HIP.Berkeley.EDU (silvia.HIP.Berkeley.EDU [136.152.64.181]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA06850 Mon, 18 Mar 1996 00:15:53 -0800 (PST) Received: (from asami@localhost) by silvia.HIP.Berkeley.EDU (8.7.5/8.6.9) id AAA02412; Mon, 18 Mar 1996 00:15:46 -0800 (PST) Date: Mon, 18 Mar 1996 00:15:46 -0800 (PST) Message-Id: <199603180815.AAA02412@silvia.HIP.Berkeley.EDU> To: jkh@time.cdrom.com CC: andreas@knobel.gun.de, doc@freebsd.org, ports@freebsd.org In-reply-to: <5159.827134097@time.cdrom.com> (jkh@time.cdrom.com) Subject: Re: HOWTO make a FreeBSD port From: asami@cs.berkeley.edu (Satoshi Asami) Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk * the mess that's currently there. I'm confident in saying that the * current "how to do a port" document is trash since I wrote quite a bit * of it! :-) I've wanted to redo it for some time. Gee thanks, however I can tell you that what is in there is quite different from what you originally wrote because it is almost totally rewritten by me! :> What we definitely need is a link from the main ports section (4.2 as of today), as some people seem to not even know the existence of this document since you moved it into the contribution part! :p Satoshi From owner-freebsd-doc Mon Mar 18 00:24:26 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA07356 for doc-outgoing; Mon, 18 Mar 1996 00:24:26 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA07337 Mon, 18 Mar 1996 00:24:22 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id AAA05424; Mon, 18 Mar 1996 00:23:58 -0800 (PST) To: asami@cs.berkeley.edu (Satoshi Asami) cc: andreas@knobel.gun.de, doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-reply-to: Your message of "Mon, 18 Mar 1996 00:15:46 PST." <199603180815.AAA02412@silvia.HIP.Berkeley.EDU> Date: Mon, 18 Mar 1996 00:23:58 -0800 Message-ID: <5422.827137438@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > * the mess that's currently there. I'm confident in saying that the > * current "how to do a port" document is trash since I wrote quite a bit > * of it! :-) I've wanted to redo it for some time. > > Gee thanks, however I can tell you that what is in there is quite > different from what you originally wrote because it is almost totally > rewritten by me! :> Hmmm. Maybe we're talking about different documents! :-) I'm talking about the one that Gary and I did. Maybe I should go back for a second look at all this. Jordan From owner-freebsd-doc Mon Mar 18 00:33:13 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA07971 for doc-outgoing; Mon, 18 Mar 1996 00:33:13 -0800 (PST) Received: from paloalto.access.hp.com (daemon@paloalto.access.hp.com [15.254.56.2]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA07950 Mon, 18 Mar 1996 00:33:10 -0800 (PST) Received: from fakir.india.hp.com by paloalto.access.hp.com with ESMTP (1.37.109.16/15.5+ECS 3.3) id AA218557967; Mon, 18 Mar 1996 00:32:54 -0800 Received: from localhost by fakir.india.hp.com with SMTP (1.37.109.16/15.5+ECS 3.3) id AA138278210; Mon, 18 Mar 1996 14:06:50 +0530 Message-Id: <199603180836.AA138278210@fakir.india.hp.com> To: Andreas Klemm Cc: Satoshi Asami , doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-Reply-To: Your message of "Mon, 18 Mar 1996 07:47:42 +0100." Date: Mon, 18 Mar 1996 14:06:49 +0530 From: A JOSEPH KOSHY Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi Andreas, ak> Uhhh.... I hust saw into the handbook, might it be, that this is ak> a new section or that it was rewritten :-( ak> 2 hours for /dev/null, *sigh*, maybe I better had asked before doing ak> the work... I liked your HOWTO a lot; could I suggest that it go into the handbook as a `real life' example? Koshy From owner-freebsd-doc Mon Mar 18 04:53:12 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id EAA20150 for doc-outgoing; Mon, 18 Mar 1996 04:53:12 -0800 (PST) Received: from burka.carrier.kiev.ua (root@burka.carrier.kiev.ua [193.125.68.131]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id EAA20127 for ; Mon, 18 Mar 1996 04:52:07 -0800 (PST) Received: from sivka.carrier.kiev.ua (root@sivka.carrier.kiev.ua [193.125.68.130]) by burka.carrier.kiev.ua (Sendmail 8.who.cares/5) with ESMTP id OAA08040 for ; Mon, 18 Mar 1996 14:52:54 +0200 Received: from elvisti.kiev.ua (uucp@localhost) by sivka.carrier.kiev.ua (Sendmail 8.who.cares/5) with UUCP id OAA04675 for doc@freebsd.org; Mon, 18 Mar 1996 14:04:17 +0200 Received: from office.elvisti.kiev.ua (office.elvisti.kiev.ua [193.125.28.33]) by spider2.elvisti.kiev.ua (8.6.12/8.ElVisti) with ESMTP id OAA16611 for ; Mon, 18 Mar 1996 14:33:56 +0200 Received: (from stesin@localhost) by office.elvisti.kiev.ua (8.6.12/8.ElVisti) id OAA08060; Mon, 18 Mar 1996 14:33:54 +0200 From: "Andrew V. Stesin" Message-Id: <199603181233.OAA08060@office.elvisti.kiev.ua> Subject: Re: HOWTO make a FreeBSD port To: andreas@knobel.gun.de (Andreas Klemm) Date: Mon, 18 Mar 1996 14:33:53 +0200 (EET) Cc: doc@freebsd.org, ports@freebsd.org In-Reply-To: <199603171911.UAA09099@knobel.gun.de> from "Andreas Klemm" at Mar 17, 96 08:11:08 pm X-Mailer: ELM [version 2.4 PL24alpha5] Content-Type: text Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hello Andreas, your real-life example is really nice. A short addition to it proposed. Q. How do I create a PLIST file for FreeBSD port of an OverBloatedFOO package, which has a very complex directory structure and too _many_ files to count them by hand? A. First of all, there is already a tool for doing such a things, called mtree. It has all kinds of smart in it and probably may be tuned for PLIST generation. (Those wizards who use it will write how can this be done ;) As I'm not familiar with mtree yet, I wrote the attached /bin/sh script, called it 'mkpkglist' and put it into my $PATH. That's how you can use it: 1. Specify a "fake" PREFIX in the port's Makefile, say /var/tmp/pkgtest. Your port _must_ be tuned so that it will cleanly install itself under whatever PREFIX value is -- as far as I know, that's a strong requirement to all FreeBSD ports. 2. Remake all the port with that fake PREFIX and do 'make reinstall'. Test the port -- does it work in a correct way from that directory? Say, it does. Ok, go on. (You'd probably like to clean the unnessesary files created while testing, if there were some). 3. Launch the script: mkpkglist /var/tmp/pkgtest > PLIST.draft So nice, the draft PLIST is here! Note, it doesn't have any mention of your fake PREFIX inside it, so you don't need to change anything in it after PREFIX is set back to /usr/local or whatever. 4. But, in case you need to do something specific in the PLIST for your package, say make yourself sure that correct permissions will be set on some binaries during the installation, or some symbolic/hard links will be established (and removed when pkg_delete will run), edit your draft PLIST by hands. Drop the result of this effort into pkg subdir of your port, under a name 'PLIST'. Now you can remove the whole subtree used as a fake PREFIX for test install -- you don't need it anymore. 5. Than set PREFIX back to a meaningful value and test the whole process once more. Than say: 'make package' -- and your'e Ok now (I hope so -- Mr. Satoshi Asami may have another opinion :) ======================== cut here ========================== : # # This simple script helps to create PLISTs for a new packages. # Probably better tools are present somewhere, too; but for now... # [ $# -eq 1 -a -d $1 ] || { echo Usage: $0 prefix_dir \> draft_PLIST >&2 exit 1 } find -d $1 | sed "s!$1/!!" | while read x do [ "$x" = $1 ] && continue [ -d $1/$x ] && { # # We preserve the directories which are always here; # case $x in bin|sbin|etc|lib|libexec|include|info) continue ;; man|man/man[0-9l]|man/cat[0-9l]) continue ;; share|share/nls|share/nls/*|share/man|share/man/*) continue ;; *) # # pkg_delete will clean everything else. # echo "@dirrm $x" ;; esac } || { echo $x # # If it's a library, launch ranlib(1) on it. # expr $x : 'lib.*\.a$' > /dev/null && echo '@exec ranlib %D/%F' } done exit 0 ======================== cut here ========================== -- With best regards -- Andrew Stesin. +380 (44) 2760188 +380 (44) 2713457 +380 (44) 2713560 "You may delegate authority, but not responsibility." Frank's Management Rule #1. From owner-freebsd-doc Mon Mar 18 10:34:35 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id KAA12194 for doc-outgoing; Mon, 18 Mar 1996 10:34:35 -0800 (PST) Received: from news1.gtn.com (news1.gtn.com [192.109.159.3]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id KAA12136 Mon, 18 Mar 1996 10:34:28 -0800 (PST) Received: (from uucp@localhost) by news1.gtn.com (8.7.2/8.7.2) id TAA23339; Mon, 18 Mar 1996 19:15:20 +0100 (MET) Received: from knobel.gun.de (localhost [127.0.0.1]) by knobel.gun.de (8.7.5/8.7.3) with SMTP id TAA01234; Mon, 18 Mar 1996 19:16:24 +0100 (MET) Date: Mon, 18 Mar 1996 19:16:24 +0100 (MET) From: Andreas Klemm To: Satoshi Asami cc: doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-Reply-To: <199603180811.AAA02398@silvia.HIP.Berkeley.EDU> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Mon, 18 Mar 1996, Satoshi Asami wrote: > * Ask Jordan. Some weeks ago he wanted me to write such a very beginner > : > * 2 hours for /dev/null, *sigh*, maybe I better had asked before doing > * the work... > > I wish you'd asked me (the ports manager) before, I have put a large > amount of work (measured in days if not weeks) to revitalize that > section, and it is quite complete now (I think). > > * But maybe there is demand for something like a "life example" ? > > Yes, I'll see if I can put it in there, it can be quite useful. But > before, can you please read the relevant section from the most > up-to-date handbook (you can get to it from www.freebsd.org) and > resubmit your "example"? You'll probably notice that there are quite > a few things that need to be changed. :) > > (I took a look at your submission the first time I saw it, one of the > reasons why I was so terse in the first mail was because I knew it > needed a big rewrite to even be considered going in there.) Ok, but could you please be more concrete, what would need to be changed ? The example itself works for me very well. Ok, my slang isn't perhaps that good, but I wanted to create a real life example, with all up's and down's ... Or can you write a port from scratch ? Ok, maybe you ;-)) But me myself has to fiddle around, until things work. And this _process_ to fine tune a port was the goal when I wrote this. Ok, maybe one could add some additional stuff... if you have a GNU source based on 'configure' you have generally to add this, if you have an X11 source you need that ... -- andreas@knobel.gun.de /\/\___ Wiechers & Partner Datentechnik GmbH Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ pgp p-key http://www-swiss.ai.mit.edu/~bal/pks-toplev.html >>> powered by <<< ftp://sunsite.unc.edu/pub/Linux/system/Printing/aps-491.tgz >>> FreeBSD <<< "Ich bleibe bei der Aussage und trotze den Flames. :-)" Ulli Horlacher 02/96 From owner-freebsd-doc Mon Mar 18 10:45:45 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id KAA14725 for doc-outgoing; Mon, 18 Mar 1996 10:45:45 -0800 (PST) Received: from news1.gtn.com (news1.gtn.com [192.109.159.3]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id KAA14671 Mon, 18 Mar 1996 10:45:36 -0800 (PST) Received: (from uucp@localhost) by news1.gtn.com (8.7.2/8.7.2) id TAA23435; Mon, 18 Mar 1996 19:15:27 +0100 (MET) Received: from knobel.gun.de (localhost [127.0.0.1]) by knobel.gun.de (8.7.5/8.7.3) with SMTP id TAA01242; Mon, 18 Mar 1996 19:17:31 +0100 (MET) Date: Mon, 18 Mar 1996 19:17:31 +0100 (MET) From: Andreas Klemm To: A JOSEPH KOSHY cc: Satoshi Asami , doc@freebsd.org, ports@freebsd.org Subject: Re: HOWTO make a FreeBSD port In-Reply-To: <199603180836.AA138278210@fakir.india.hp.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Mon, 18 Mar 1996, A JOSEPH KOSHY wrote: > I liked your HOWTO a lot; could I suggest that it go into the handbook > as a `real life' example? Thanks, seems to me that I already have three fan's including myself ;-)) -- andreas@knobel.gun.de /\/\___ Wiechers & Partner Datentechnik GmbH Andreas Klemm ___/\/\/ $$ Support Unix - aklemm@wup.de $$ pgp p-key http://www-swiss.ai.mit.edu/~bal/pks-toplev.html >>> powered by <<< ftp://sunsite.unc.edu/pub/Linux/system/Printing/aps-491.tgz >>> FreeBSD <<< "Ich bleibe bei der Aussage und trotze den Flames. :-)" Ulli Horlacher 02/96 From owner-freebsd-doc Tue Mar 19 05:51:08 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id FAA28973 for doc-outgoing; Tue, 19 Mar 1996 05:51:08 -0800 (PST) Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id FAA28967 Tue, 19 Mar 1996 05:51:06 -0800 (PST) Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id IAA01209; Tue, 19 Mar 1996 08:51:02 -0500 Date: Tue, 19 Mar 1996 08:51:01 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: Satoshi Asami cc: andreas@knobel.gun.de, doc@FreeBSD.ORG, ports@FreeBSD.ORG Subject: Re: HOWTO make a FreeBSD port In-Reply-To: <199603172230.OAA18571@sunrise.cs.berkeley.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk On Sun, 17 Mar 1996, Satoshi Asami wrote: > I'm sorry, but there already is a "how to make a port" in the > Handbook. It's buried somewhere in the "how to contribute" section, > maybe that's why you didn't see it. It *used* to be in a more prominent place, but Jordan burried it. :( -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Tue Mar 19 07:11:23 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id HAA07055 for doc-outgoing; Tue, 19 Mar 1996 07:11:23 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id HAA07005 Tue, 19 Mar 1996 07:11:09 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id HAA01658; Tue, 19 Mar 1996 07:09:59 -0800 (PST) To: John Fieber cc: Satoshi Asami , andreas@knobel.gun.de, doc@FreeBSD.ORG, ports@FreeBSD.ORG Subject: Re: HOWTO make a FreeBSD port In-reply-to: Your message of "Tue, 19 Mar 1996 08:51:01 EST." Date: Tue, 19 Mar 1996 07:09:59 -0800 Message-ID: <1656.827248199@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk OK, OK, I'll do something about it already! :-) > On Sun, 17 Mar 1996, Satoshi Asami wrote: > > > I'm sorry, but there already is a "how to make a port" in the > > Handbook. It's buried somewhere in the "how to contribute" section, > > maybe that's why you didn't see it. > > It *used* to be in a more prominent place, but Jordan burried it. :( > > > -john > > == jfieber@indiana.edu =========================================== > == http://fieber-john.campusview.indiana.edu/~jfieber ============ > From owner-freebsd-doc Tue Mar 19 18:46:18 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id SAA22821 for doc-outgoing; Tue, 19 Mar 1996 18:46:18 -0800 (PST) Received: from coyote.rain.org (sdcannon@coyote.rain.org [198.68.144.2]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id SAA22803 for ; Tue, 19 Mar 1996 18:46:10 -0800 (PST) Received: (from sdcannon@localhost) by coyote.rain.org (8.6.12/CSE) id SAA23330; Tue, 19 Mar 1996 18:44:35 -0800 Date: Tue, 19 Mar 1996 18:44:35 -0800 (PST) From: Tink To: doc@freebsd.com Subject: A helpful addition (I hope) Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk I am a computer fossil - date back to the days of the vacuum tubes - but I am on a UNIX crash course... I got FreeBSD from walnut creek, and proceeded to install on one of my machines. No problems, and I was truely impressed in the hardware recognition capabilities which went without a hitch - you guys are really turning out good stuff... Two improvements for fossils that have no idea how to spell UN?X-- In the install.txt file make mention of where the handbook is located - the handbook contains a wealth of information, some pertanent, some not, but for me, it was extremely useful. The documentation stops at the point that you ger "LOGIN:" - remembering that I am a fossil, I am not privy to the standard logins that apparently pervade the unix worls - I took off my business suit and put on my propeller topped beenie and figgured it all out, but including a copy of the password.db file in install.txt would save new naieve installers like me many hours... I hope at some future time to be a contributor... depends on the learning curve... Many thanks for a truely neet product - Steve - (aka tink) From owner-freebsd-doc Wed Mar 20 02:24:54 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id CAA22266 for doc-outgoing; Wed, 20 Mar 1996 02:24:54 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id CAA22255 for ; Wed, 20 Mar 1996 02:24:48 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id CAA05581; Wed, 20 Mar 1996 02:24:34 -0800 (PST) To: Tink cc: doc@freebsd.com Subject: Re: A helpful addition (I hope) In-reply-to: Your message of "Tue, 19 Mar 1996 18:44:35 PST." Date: Wed, 20 Mar 1996 02:24:34 -0800 Message-ID: <5579.827317474@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk > In the install.txt file make mention of where the handbook is located - > the handbook contains a wealth of information, some pertanent, some not, > but for me, it was extremely useful. You evidently didn't read the README.TXT file, something that you're actually sort of expected to read first.. :-) >From README.TXT: The Handbook and FAQ are also available as on-line documents in /usr/share/doc and can be read using the ``file:/usr/share/doc'' syntax in any HTML capable browser. > The documentation stops at the point that you ger "LOGIN:" - remembering > that I am a fossil, I am not privy to the standard logins that apparently > pervade the unix worls - I took off my business suit and put on my Hmmm. When you installed the system before it used to tell you that you could log in as root, but evidently this message got nuked somewhere along the line (I just went and looked). I'll put it back, sorry! > Many thanks for a truely neet product - Steve - (aka tink) You're welcome! Jordan From owner-freebsd-doc Wed Mar 20 02:39:27 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id CAA23191 for doc-outgoing; Wed, 20 Mar 1996 02:39:27 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id CAA23185 for ; Wed, 20 Mar 1996 02:39:23 -0800 (PST) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id CAA05647; Wed, 20 Mar 1996 02:38:58 -0800 (PST) To: Michael Smith cc: doc@freebsd.org Subject: Re: PCI ethernet boards (fwd) In-reply-to: Your message of "Tue, 12 Mar 1996 12:35:03 +1030." <199603120205.MAA24697@genesis.atrad.adelaide.edu.au> Date: Wed, 20 Mar 1996 02:38:58 -0800 Message-ID: <5645.827318338@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > > Ok doc-people, we have a bogon. The handbook list should say > > DEC DC21040/DC21041/DC21140 based NICs: Fixed. Hey, don't you have commit privileges? :-) Jordan From owner-freebsd-doc Wed Mar 20 09:30:27 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA18513 for doc-outgoing; Wed, 20 Mar 1996 09:30:27 -0800 (PST) Received: from Fe3.rust.net (Fe3.rust.net [204.157.12.254]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id JAA18502 for ; Wed, 20 Mar 1996 09:30:24 -0800 (PST) Received: from home (liv-2.rust.net [206.42.195.102]) by Fe3.rust.net (8.7.4/8.7.3) with SMTP id MAA17997 for ; Wed, 20 Mar 1996 12:31:01 -0500 (EDT) Message-ID: <31504173.6ABD@aol2.com> Date: Wed, 20 Mar 1996 12:33:39 -0500 From: Neil Organization: Almighty Online X-Mailer: Mozilla 2.0GoldB1 (Win95; I) MIME-Version: 1.0 To: doc@freebsd.org Subject: Installing from DOS. X-URL: http://sunsite.mff.cuni.cz/www.freebsd.org/handbook/handbook17.html#19 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk I have a 1.2 GIG Maxtor HD.. it is partitioned: 1 - DOS/(Win95) - on it C:\FREEBSD \bin (with all bins) \dict \compat (1x and 20) \floppies \manpages \packages I make a boot disk, partition a large FreeBSD set.. do the auto maker (with the disklabel editor). so it looks like this: Part Mount Size Newfs ---- ----- ---- ----- wd0s1 226MB DOS wd0s2a / 32MB UFS Y wd0s2b 107MB SWAP wd0s2e /var 30MB UFS Y wd0s2f /usr 827MB UFS Y then it says.. Loading root image from: wd0s1 then it says.. Failed to load the ROOT distribution. Please correct this problem and try again. --- I don't know how to correct this problem. Should I copy the C:\FREEBSD directory to my ROOT directory instead? I am stumped! Thanks, Neil mailto:neil@aol2.com phone:(810) 442-9046 From owner-freebsd-doc Wed Mar 20 11:11:21 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id LAA25423 for doc-outgoing; Wed, 20 Mar 1996 11:11:21 -0800 (PST) Received: from smailie.think.de (root@smailie.think.de [194.120.140.250]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id LAA25418 for ; Wed, 20 Mar 1996 11:11:17 -0800 (PST) Received: from wuff.franken.de by smailie.think.de with smtp (Smail3.1.29.1 #3) id m0tzTTh-0007KYA; Wed, 20 Mar 96 20:23 MET Received: from lorien.franken.de by wuff.franken.de with uucp (Smail3.1.29.1 #20) id m0tzTHk-000P0vA; Wed, 20 Mar 96 20:11 MET Received: from rak.franken.de by lorien.franken.de with smtp (Linux Smail3.1.29.1 #2) id m0tzT3p-0001YnE; Wed, 20 Mar 96 19:56 MET Received: by rak.franken.de (FreeBSD Smail3.1.29.1 #1) id m0tzTxR-000049E; Wed, 20 Mar 96 19:54 Message-Id: From: _@rak.franken.de (Stephanie 'Atrak' Wehner) Subject: ps version of handbook To: doc@freebsd.org Date: Wed, 20 Mar 1996 19:54:09 +0000 () X-Mailer: ELM [version 2.4 PL24 ME8] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi, I was wondering whether there is a ps version of the freebsd handbook yet. Maybe it would be nice to have a version to print out and so to have a little paper handbook. The Linux Khg for example, can be printed out, so it makes up a real book. Since I've often seen people asking for freebsd documentation on paper, I would typeset the Handbook, so it could be downloaded as a dvi and ps text using latex. I've only just send the mail away to join the freebsd-doc mailinglist, so I'm sorry if my information about the FreeBSD documentation project may not be up to date. bye, atrak From owner-freebsd-doc Wed Mar 20 18:15:34 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id SAA26807 for doc-outgoing; Wed, 20 Mar 1996 18:15:34 -0800 (PST) Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id SAA26797 for ; Wed, 20 Mar 1996 18:15:28 -0800 (PST) Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id VAA05959; Wed, 20 Mar 1996 21:14:35 -0500 Date: Wed, 20 Mar 1996 21:14:34 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: "Stephanie 'Atrak' Wehner" <_@rak.franken.de> cc: doc@freebsd.org Subject: Re: ps version of handbook In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Wed, 20 Mar 1996, Stephanie 'Atrak' Wehner wrote: > I was wondering whether there is a ps version of the freebsd handbook ftp://ftp.freebsd.org/pub/FreeBSD/docs. It isn't the absolute latest version, but probably close enough. It is about 350 pages. -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Wed Mar 20 23:04:34 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id XAA29290 for doc-outgoing; Wed, 20 Mar 1996 23:04:34 -0800 (PST) Received: from mail.telstra.com.au (mail.telstra.com.au [192.148.160.10]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id XAA29281 for ; Wed, 20 Mar 1996 23:04:19 -0800 (PST) Received: from mail_gw.fwall.telecom.com.au(192.148.147.10) by mail via smap (V1.3) id sma027475; Thu Mar 21 10:15:08 1996 Received: from netbsd08.dn.itg.telecom.com.au(144.139.63.32) by mail_gw.telecom.com.au via smap (V1.3) id sma007203; Thu Mar 21 17:01:21 1996 Received: from netbsd08.dn.itg.telecom.com.au (netbsd08.dn.itg.telecom.com.au [144.139.63.32]) by netbsd08.dn.itg.telecom.com.au (8.6.8/8.6.6) with SMTP id PAA08782 for ; Thu, 21 Mar 1996 15:09:31 +0800 Message-Id: <199603210709.PAA08782@netbsd08.dn.itg.telecom.com.au> From: Terry Dwyer Date: Thu, 21 Mar 96 15:09:32 800 To: doc@freebsd.org Mime-Version: 1.0 X-Mailer: Mozilla/1.0N (X11; uname failed) Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Subject: size of handbook. X-URL: http://www.au.freebsd.org/FreeBSD/docs.html Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hello Guys, This is an impressive document. The only comment I want to make is a suggestion: Please break it up into smaller pieces. I tried to print the file to a HP Laserjet IV with 12MB of ram (I think thats what's in it), and at about page 220 it failed, saying something like "file too big" Other than that, what a great job. Thanks for the great product. Terry From owner-freebsd-doc Thu Mar 21 00:50:35 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA08407 for doc-outgoing; Thu, 21 Mar 1996 00:50:35 -0800 (PST) From: owner-doc Received: from q8n.q8.dk (q8t.q8.dk [193.89.96.65]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id AAA08402 for ; Thu, 21 Mar 1996 00:50:24 -0800 (PST) Received: by q8n.q8.dk (Smail3.1.29.1 #19) id m0tzg4R-000067C; Thu, 21 Mar 96 09:50 MET Message-Id: Date: Thu, 21 Mar 96 09:50 MET To: doc@freebsd.org X-Mailer: Lynx, Version 2.3 BETA Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk From owner-freebsd-doc Thu Mar 21 00:57:43 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id AAA08870 for doc-outgoing; Thu, 21 Mar 1996 00:57:43 -0800 (PST) Received: from csmd.cs.uni-magdeburg.de (csmd.cs.uni-magdeburg.de [141.44.22.100]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id AAA08860 for ; Thu, 21 Mar 1996 00:57:22 -0800 (PST) Message-Id: <199603210857.AAA08860@freefall.freebsd.org> Received: from csmd49.cs.uni-magdeburg.de by csmd.cs.uni-magdeburg.de with SMTP (1.38.193.5/16.2) id AA24936; Thu, 21 Mar 1996 10:01:10 +0100 Received: by csmd49.cs.uni-magdeburg.de (1.37.109.11/16.2) id AA017428869; Thu, 21 Mar 1996 10:01:09 +0100 From: Roland Jesse Subject: Re: size of handbook. To: tdwyer@netbsd08.dn.itg.telecom.com.au (Terry Dwyer) Date: Thu, 21 Mar 1996 10:01:09 +0100 (MEZ) Cc: doc@FreeBSD.org In-Reply-To: <199603210709.PAA08782@netbsd08.dn.itg.telecom.com.au> from "Terry Dwyer" at Mar 21, 96 03:09:32 pm X-Mailer: ELM [version 2.4 PL24 ME6] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@FreeBSD.org X-Loop: FreeBSD.org Precedence: bulk Quoting Terry Dwyer: > > This is an impressive document. > The only comment I want to make is a suggestion: > Please break it up into smaller pieces. Try translating it with latex. Take the .dvi file and produce a number of small postscript files with dvips. Use 'dvips -p -l -o print.ps handbook.dvi'. In this way you can print out each page alone. ;-) Roland -- "Who the hell is General Failure?" - "And why is he reading my harddisk?" -- +---------------------------------------------------------------------+ | Roland (rj,-) Jesse, | | stud.rer.nat. et phil. http://www.cs.uni-magdeburg.de/~jesse/ | +------ pgp public key via keyserver or mail with subject ##key ------+ From owner-freebsd-doc Thu Mar 21 17:32:53 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id RAA03146 for doc-outgoing; Thu, 21 Mar 1996 17:32:53 -0800 (PST) Received: from mail.telstra.com.au (mail.telstra.com.au [192.148.160.10]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id RAA03141 for ; Thu, 21 Mar 1996 17:32:49 -0800 (PST) Received: from mail_gw.fwall.telecom.com.au(192.148.147.10) by mail via smap (V1.3) id sma013135; Fri Mar 22 04:42:11 1996 Received: from netbsd08.dn.itg.telecom.com.au(144.139.63.32) by mail_gw.telecom.com.au via smap (V1.3) id sma016787; Fri Mar 22 11:27:52 1996 Received: from netbsd08.dn.itg.telecom.com.au (netbsd08.dn.itg.telecom.com.au [144.139.63.32]) by netbsd08.dn.itg.telecom.com.au (8.6.8/8.6.6) with SMTP id JAA16832; Fri, 22 Mar 1996 09:35:59 +0759 Date: Fri, 22 Mar 1996 09:35:59 +0800 (WST) From: Terry Dwyer To: Roland Jesse cc: doc@FreeBSD.org, Gong Wei Subject: Re: size of handbook. In-Reply-To: <199603210211.MAA05500@mail.telstra.com.au> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@FreeBSD.org X-Loop: FreeBSD.org Precedence: bulk On Thu, 21 Mar 1996, Roland Jesse wrote: > Quoting Terry Dwyer: > > > > This is an impressive document. > > The only comment I want to make is a suggestion: > > Please break it up into smaller pieces. > I've solved my problem in an extremely user-friendly way using ghostscript. It allows you to mark an arbritrary block of pages and save them to a file, or print them. I saved each 100 pages to a file, ftp'ed them to work and printed the missed pages. Thank you for your replies. _-_|\ Terry Dwyer E-Mail: tdwyer@netbsd08.dn.itg.telecom.com.au / \ System Administrator Phone: +61 9 491 5161 Fax: +61 9 221 2631 *_.^\_/ Telecom Australia Telstra Corporation MIME capable mailer v Perth WA ( I do not speak for Telstra or Telecom ) From owner-freebsd-doc Fri Mar 22 12:37:27 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id MAA28290 for doc-outgoing; Fri, 22 Mar 1996 12:37:27 -0800 (PST) Received: from seed.acprog.ifas.ufl.edu (seed.acprog.ifas.ufl.edu [128.227.113.11]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id MAA28285 for ; Fri, 22 Mar 1996 12:37:23 -0800 (PST) Received: from sand (sand.acprog.ifas.ufl.edu [128.227.113.13]) by seed.acprog.ifas.ufl.edu (8.6.12/8.6.12) with SMTP id PAA18756 for ; Fri, 22 Mar 1996 15:36:05 -0500 Message-ID: <31530F50.24D8@acprog.ifas.ufl.edu> Date: Fri, 22 Mar 1996 15:36:32 -0500 From: Gerir Lopez-Fernandez Organization: IFAS Academic Programs, University of Florida X-Mailer: Mozilla 2.0 (X11; I; SunOS 5.5 sun4m) MIME-Version: 1.0 To: doc@freebsd.org Subject: Volunteering X-URL: http://www.freebsd.org/handbook/handbook.html Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi! My name is Gerir Lopez-Fernandez and I'm currently a sysadmin for the IFAS Academic Programs office at the University of Florida. While I have not used FreeBSD (yet!, I hope to get a box soon enough to do so), I have extensive experience with BSDI, and I'm interested in helping out with the documentation project in any way I can. Sincerely, -Gerir ============================================================ ** ALBA ** ==== | Gerir Lopez-Fernandez | | | Un*x Senior Systems Administrator | | | E-mail: glf@acprog.ifas.ufl.edu | Puerto Rico does it better! (TM) | | WWW: www.acprog.ifas.ufl.edu/~glf | Spain, everything under the sun (TM) | | | | | IFAS Academic Programs | | | University of Florida |--------------------------------------| | 2107 McCarty Hall | DISCLAIMER | | Gainesville, Fl 32611 | The opinions hereby expressed are my| | Voice: (904) 846-1168 | own and do not necessarily represent| | Fax: (904) 392-8988 | those of the school I attend/work for| ============================================================================