From owner-freebsd-doc@FreeBSD.ORG Sun Apr 11 12:53:14 2010 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5415E106564A for ; Sun, 11 Apr 2010 12:53:14 +0000 (UTC) (envelope-from www@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 2AA478FC12 for ; Sun, 11 Apr 2010 12:53:14 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3BCrDd0004119 for ; Sun, 11 Apr 2010 12:53:13 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3BCrDQA004118 for freebsd-doc@FreeBSD.org; Sun, 11 Apr 2010 12:53:13 GMT (envelope-from www) Date: Sun, 11 Apr 2010 12:53:13 GMT From: World Wide Web Owner Message-Id: <201004111253.o3BCrDQA004118@www.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: Subject: FreeBSD web build failed on www.freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Apr 2010 12:53:14 -0000 From owner-freebsd-doc@FreeBSD.ORG Sun Apr 11 13:08:15 2010 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F05E2106566C for ; Sun, 11 Apr 2010 13:08:15 +0000 (UTC) (envelope-from www@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id C78D58FC1E for ; Sun, 11 Apr 2010 13:08:15 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3BD8Ff8028809 for ; Sun, 11 Apr 2010 13:08:15 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3BD8FHw028808 for freebsd-doc@FreeBSD.org; Sun, 11 Apr 2010 13:08:15 GMT (envelope-from www) Date: Sun, 11 Apr 2010 13:08:15 GMT From: World Wide Web Owner Message-Id: <201004111308.o3BD8FHw028808@www.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: Subject: FreeBSD web build failed on www.freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Apr 2010 13:08:16 -0000 From owner-freebsd-doc@FreeBSD.ORG Sun Apr 11 16:24:56 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 318AD106564A for ; Sun, 11 Apr 2010 16:24:56 +0000 (UTC) (envelope-from egoitz@ramattack.net) Received: from ks200575.kimsufi.com (ks200575.kimsufi.com [91.121.111.71]) by mx1.freebsd.org (Postfix) with ESMTP id EEAD98FC18 for ; Sun, 11 Apr 2010 16:24:55 +0000 (UTC) Received: from [192.168.12.230] (44.Red-80-35-101.staticIP.rima-tde.net [80.35.101.44]) by ks200575.kimsufi.com (Postfix) with ESMTP id 7D7C7AC88 for ; Sun, 11 Apr 2010 17:25:11 +0000 (UTC) From: Egoitz Aurrekoetxea Aurre Date: Sun, 11 Apr 2010 18:24:53 +0200 Message-Id: <4DFBF8DF-3236-420C-96D0-FF50E5DD4EBD@ramattack.net> To: freebsd-doc@freebsd.org Mime-Version: 1.0 (Apple Message framework v1078) X-Mailer: Apple Mail (2.1078) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: FreeBSD pxe installation server howto X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Apr 2010 16:24:56 -0000 Hi, I'm working on a project for setting up a freebsd installation server = with pxe. When I started I see the doc was a bit old-fashioned... so I = started looking at some blogs... freebsd doc that could help me = understanding the whole process and so on... finally I have ended = looking at source code of some involved parts like sysintall, boot = stages and so on.... for understanding all properly for setting up this = service. I have written a documentation that if you see it to be ok... = (it seems to be working fine) perhaps, would be nice to appear in = handbook or in some official documentation site... So if you see = something that should be done in another way... or some point wich you = consider it's wrong... please make me know and I'll correct it. The url = in wich you could fetch the pdf file is = :http://postfixquotareject.ramattack.net/freebsdpxehowto.pdf Thank you very much. Bye!!= From owner-freebsd-doc@FreeBSD.ORG Sun Apr 11 18:15:44 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1E86A106564A for ; Sun, 11 Apr 2010 18:15:44 +0000 (UTC) (envelope-from egoitz@ramattack.net) Received: from ks200575.kimsufi.com (ks200575.kimsufi.com [91.121.111.71]) by mx1.freebsd.org (Postfix) with ESMTP id DB25E8FC14 for ; Sun, 11 Apr 2010 18:15:43 +0000 (UTC) Received: from [192.168.12.230] (44.Red-80-35-101.staticIP.rima-tde.net [80.35.101.44]) by ks200575.kimsufi.com (Postfix) with ESMTP id 93315AC87 for ; Sun, 11 Apr 2010 19:15:59 +0000 (UTC) Content-Type: text/plain; charset=iso-8859-1 Mime-Version: 1.0 (Apple Message framework v1078) From: Egoitz Aurrekoetxea Aurre In-Reply-To: <4BC1FF40.3080500@locolomo.org> Date: Sun, 11 Apr 2010 20:15:42 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: <82A8CE62-656D-4365-99F1-D0FB817EEEA0@ramattack.net> References: <4BC1FF40.3080500@locolomo.org> To: freebsd-doc@freebsd.org X-Mailer: Apple Mail (2.1078) Subject: Re: FreeBSD PXE installation howto X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Apr 2010 18:15:44 -0000 Hi Erik, I see.... you know like the first place you look is at handbook... yep I = have read too you're guide sometime... seems another way of doing the = same... One suggest only... this is not correct... # cd /usr/src/sys/boot # make -DLOADER_TFTP_SUPPORT=3DYES has no effect... in the Makefiles you will see it's checking a variable = independently of the value the variable contains... and in a make line = setting a define AFAIK has not much sense... Make will do all with the default nfs support. Bye!! El 11/04/2010, a las 18:56, Erik Norgaard escribi=F3: > On 11/04/10 18:21, Egoitz Aurrekoetxea Aurre wrote: >=20 >> I'm working on a project for setting up a freebsd installation server = with pxe. When I started I see the doc was a bit old-fashioned... so I = started looking at some blogs... freebsd doc that could help me = understanding the whole process and so on... finally I have ended = looking at source code of some involved parts like sysintall, boot = stages and so on.... for understanding all properly for setting up this = service. I have written a documentation that if you see it to be ok... = (it seems to be working fine) perhaps, would be nice to appear in = handbook or in some official documentation site... So if you see = something that should be done in another way... or some point wich you = consider it's wrong... please make me know and I'll correct it. The url = in wich you could fetch the pdf file is : = http://postfixquotareject.ramattack.net/freebsdpxehowto.pdf >=20 > I don't know which docs you have seen, I recently updated my guide to = FBSD8, www.locolomo.org/howto/pxeboot/ >=20 > BR, Erik >=20 > --=20 > Erik N=F8rgaard > Ph: +34.666334818/+34.915211157 = http://www.locolomo.org From owner-freebsd-doc@FreeBSD.ORG Sun Apr 11 19:40:01 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6B55C1065670 for ; Sun, 11 Apr 2010 19:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2A9648FC13 for ; Sun, 11 Apr 2010 19:40:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3BJe172099417 for ; Sun, 11 Apr 2010 19:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3BJe0N2099416; Sun, 11 Apr 2010 19:40:01 GMT (envelope-from gnats) Resent-Date: Sun, 11 Apr 2010 19:40:01 GMT Resent-Message-Id: <201004111940.o3BJe0N2099416@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Conall O'Brien" Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B6B95106564A for ; Sun, 11 Apr 2010 19:31:34 +0000 (UTC) (envelope-from conall@daedalus.asclepian.ie) Received: from daedalus.asclepian.ie (daedalus.ipv4.asclepian.ie [213.133.100.226]) by mx1.freebsd.org (Postfix) with ESMTP id 7EEAD8FC1C for ; Sun, 11 Apr 2010 19:31:33 +0000 (UTC) Received: by daedalus.asclepian.ie (Postfix, from userid 1001) id F34ADB855; Sun, 11 Apr 2010 20:31:30 +0100 (IST) Message-Id: <20100411193130.F34ADB855@daedalus.asclepian.ie> Date: Sun, 11 Apr 2010 20:31:30 +0100 (IST) From: "Conall O'Brien" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/145631: References to ttyd0 serial devices in handbook need to be updated for FreeBSD 8.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Conall O'Brien List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Apr 2010 19:40:01 -0000 >Number: 145631 >Category: docs >Synopsis: References to ttyd0 serial devices in handbook need to be updated for FreeBSD 8.0 >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Apr 11 19:40:00 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Conall O'Brien >Release: FreeBSD 7.2-STABLE amd64 >Organization: >Environment: System: FreeBSD daedalus.asclepian.ie 7.2-STABLE FreeBSD 7.2-STABLE #9: Sat Jun 27 00:05:26 IST 2009 root@daedalus.asclepian.ie:/usr/src/obj/usr/src/sys/DAEDALUS amd64 >Description: Handbook's handbook/serialconsole-setup.html page refers to ttyd0 as the default serial console of a system. As of FreeBSD 8.0, ttyu0 is the default port, so the docs need to be updated to handle both devices. >How-To-Repeat: Read serialconsole-setup.html while configuring a fresh install of FreeBSD 8.0 >Fix: grep through the handbook and other docs for references to ttyd0 and update to refer to ttyd0 or ttyu0 (FreeBSD 8.0 and higher) >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 05:03:30 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 00B6E106566B for ; Mon, 12 Apr 2010 05:03:30 +0000 (UTC) (envelope-from egoitz@ramattack.net) Received: from ks200575.kimsufi.com (ks200575.kimsufi.com [91.121.111.71]) by mx1.freebsd.org (Postfix) with ESMTP id 8CD9B8FC12 for ; Mon, 12 Apr 2010 05:03:29 +0000 (UTC) Received: from [192.168.12.230] (44.Red-80-35-101.staticIP.rima-tde.net [80.35.101.44]) by ks200575.kimsufi.com (Postfix) with ESMTP id F0FAFA888 for ; Mon, 12 Apr 2010 06:03:44 +0000 (UTC) Content-Type: text/plain; charset=iso-8859-1 Mime-Version: 1.0 (Apple Message framework v1078) From: Egoitz Aurrekoetxea Aurre In-Reply-To: <4BC2A291.5020807@a1poweruser.com> Date: Mon, 12 Apr 2010 07:03:27 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: References: <4BC2A291.5020807@a1poweruser.com> To: freebsd-doc@freebsd.org X-Mailer: Apple Mail (2.1078) Subject: Re: FreeBSD PXE installation howto X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 05:03:30 -0000 Hi all, Erik when you specify there -DLOADER_TFTP_SUPPORT=3DYES this is a = directive for the preprocessor in the time it is looking wich source = code to compile... but it should be entered in cc line... not in make... = just do one check.... save the output of that make to a file and you = will see that nfs support is going to be used... check too the = makefiles... you will see that makefiles to enter the = -DLOADER_TFTP_SUPPORT they are checking if make variable = LOADER_TFTP_SUPPORT is initialized to something... you could perhaps = do...=20 export CPPFLAGS=3D"-DLOADER_TFTP_SUPPORT=3DYES"=20 make but not the way you said... and I won't do things this way too... just = use makefile for this kind of flags... as I say basically... make LOADER_TFTP_SUPPORT=3DYES try this and the way you set and you will see different output of make. The suggested parts to correct corrected... tftpd run from inetd is the same as base system really... so this is = done.... Fbsd1 I'll try to improve this aspects of the doc... yep perhaps I have = explained a little for me :)... Well if any developer could check too this howto, will be just fine :) Thankss a lot :) to all. bye!!! El 12/04/2010, a las 06:33, Fbsd1 escribi=F3: > Egoitz Aurrekoetxea Aurre wrote: > > Hi, > > > > I'm working on a project for setting up a freebsd installation = server > with pxe. > > When I started I see the doc was a bit old-fashioned. so I started > > looking at some blogs. freebsd doc that could help me understanding > > the whole process and so on. Finally I have ended looking at source > > code of some involved parts like sysintall, boot stages and so on = for > > understanding all properly for setting up this service. > > I have written a documentation that if you see it to be ok. (it = seems > > to be working fine) perhaps, would be nice to appear in handbook or > > in some official documentation site. So if you see something that > > should be done in another way, or some point which you consider is > > wrong, please make me know and I'll correct it. > > > > The url in which you could fetch the pdf file is : > > > > http://postfixquotareject.ramattack.net/freebsdpxehowto.pdf > > > > Thank you very much. > > > > > > >=20 >=20 > Thank you Egoitz for volunteering to write documentation for the = handbook. The following criticism is not meant in a negative way. >=20 > I can not evaluate the correctness of the technical procedure you = write about, but I am going to talk about your style of written = documentation. >=20 > What you have written is what I would call a personal short cut = outline of the steps you did. So next time you need to do the same thing = again you have something to follow and remind youself of what you did. = This only has value to you because you have in your head all the = understanding and background information of why you are doing these = steps. >=20 > When writhing documentation for the handbook you must keep in mind = that the reader has no idea what you are talking about. So your document = has to contain right at the beginning an explanation of what PBX is, how = you are using it, what other programs you are using and why. The general = rule is MORE details is better then LESS details. Explain what and why = for each step. >=20 > Know that the reader will execute every command just as you wrote = them, so test the sequence of commands to verify it's correct. This is a = very important step in writing documentation. It has to produce the = exact results you say it will. >=20 > Adding or replacing a section in the handbook takes a long time. Maybe = 1 or 2 RELEASE versions before it gets added. The documentation = department moves slowly. The technical stuff in the document is reviewed = by some of the developers for accuracy. >=20 > I know what I am talking about because I am the author of the handbook = Firewall section. I am willing to help and guide you through this = process. I suggest you put your document in Microsoft Word, add the = background information and step details talked about above, and then = attach it to an email for my review. >=20 > Let me know if you choose to proceed. >=20 > Joe >=20 >=20 >=20 >=20 >=20 >=20 >=20 >=20 >=20 From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 09:40:08 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BA6281065672 for ; Mon, 12 Apr 2010 09:40:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 87B1D8FC2B for ; Mon, 12 Apr 2010 09:40:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3C9e1KW064600 for ; Mon, 12 Apr 2010 09:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3C9e1tK064599; Mon, 12 Apr 2010 09:40:01 GMT (envelope-from gnats) Resent-Date: Mon, 12 Apr 2010 09:40:01 GMT Resent-Message-Id: <201004120940.o3C9e1tK064599@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Joe Barbish Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 86427106566B for ; Mon, 12 Apr 2010 09:30:18 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 739148FC0A for ; Mon, 12 Apr 2010 09:30:18 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3C9UIjP009468 for ; Mon, 12 Apr 2010 09:30:18 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3C9UIPC009467; Mon, 12 Apr 2010 09:30:18 GMT (envelope-from nobody) Message-Id: <201004120930.o3C9UIPC009467@www.freebsd.org> Date: Mon, 12 Apr 2010 09:30:18 GMT From: Joe Barbish To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145644: Add artical about creating manpage from scratch X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 09:40:08 -0000 >Number: 145644 >Category: docs >Synopsis: Add artical about creating manpage from scratch >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Apr 12 09:40:01 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Joe Barbish >Release: 8.0 release >Organization: none >Environment: >Description: The FreeBSD documentation environment is lacking instructions on how to create “man page” manuals. I have written a ‘How To’ document titled; Creating a manpage from scratch. It’s too big for the FAQ list, but fits nicely into the article size. You can read it online at http://www.daemonforums.org/showthread.php?t=4602 I am donating it to the FreeBSD document team with the hopes you will take the text file I have attached and convert it to SGML and add it as an article. >How-To-Repeat: >Fix: Patch attached with submission follows: Creating a manpage from scratch. What is a manpage? The FreeBSD documentation manuals system is comprised on many manuals that are intended to by displayed on-line from the command line using the “man” command. Every Base RELEASE command has it’s own manual as well as the commands introduced by the ports system. The layout of the manual is standardized by the use of groff_mdoc(7) documentation macro markup language. The files containing the source for each manual are located in the /usr/share/man/manX/ directory tree, where the X of manX is one of the following sections. Under FreeBSD 8.0, the following sections are defined: 1 FreeBSD General Commands Manual 2 FreeBSD System Calls Manual 3 FreeBSD Library Functions Manual 4 FreeBSD Kernel Interfaces Manual 5 FreeBSD File Formats Manual 6 FreeBSD Games Manual 7 FreeBSD Miscellaneous Information Manual 8 FreeBSD System Manager's Manual 9 FreeBSD Kernel Developer's Manual So you would see this /usr/share/man/man1/ /usr/share/man/man2/ /usr/share/man/man3/ /usr/share/man/man4/ /usr/share/man/man5/ /usr/share/man/man6/ /usr/share/man/man7/ /usr/share/man/man8/ /usr/share/man/man9/ Manual File Naming Standard. There is a standardized naming convention in place for manpage files: name.X.gz Where name = the name of the command being documented. X = the manual section its in from the above path list. gz = means the file has been compress with gzip(1) command. The file itself is a text file with the documentation being prefixed and sometimes enclosed with formatting macros from groff_mdoc(7) markup language. Take note; The macro text file should contain no blank lines in it. Creating The Manual Source File. The best way to get started is to just copy a man page from the base system and edit it to taste. As the system administrator I always login as user root so the following command examples and manual sample are developed in /root. The manual for the jail(8) command will be used as the template for my new manual ezjail. cd /root cp /usr/share/man/man8/jail.8.gz /root/ # get my own copy of file. mv jail.8.gz ezjail.8.gz # rename the file. gunzip ezjail.8.gz # unzip the file. ee ezjail.8 # edit the text file. The start of the text file has the standard FreeBSD copyright comments. Delete all these comments. All groff_mdoc(7) documentation line macros begin with an period “.” Then an uppercase letter followed by a lowercase letter. The following discussion has comments to the right and these comments are not part of the macro command syntax, but put here to explain what’s happening. So starting the new ezjail manpage text file is; # Setup the manual format section .Dd July 22, 2010 # Date displayed on center of last line. .Dt EZJAIL 8 # Name and section of this manpage, # has to be in uppercase letters, # displays left & right corners of top line. .Os # Displays RELEASE version in left & right # corners of last line. # This is how the man command displays the first and last lines EZJAIL(8) FreeBSD System Manager's Manual EZJAIL(8) FreeBSD 8.0 July 22, 2010 FreeBSD 8.0 # Setup the highlighted first two lines you see. .Sh NAME # Section header name in uppercase letters. .Nm ezjail # Name to display. .Nd “description” # short description of command. # This is what is displayed by the man command NAME ezjail -- description # Setup the command syntax section .Sh SYNOPSIS # Section header name in uppercase letters. .Nm # Display saved name. # The following macros format the flags in bold and/or with brackets # and with white background / black letters. .Op Fl dhi .Op Fl J Ar jid_file .Op Fl l u Ar username | Fl U Ar username .Op Fl c | m .Br .Nm .Op Fl hi .Op Fl n Ar jailname .Op Fl J Ar jid_file .Op Fl s Ar securelevel .Op Fl l u Ar username | Fl U Ar username .Op Ar path hostname [ip[,..]] command ... # This is what is displayed by the man command SYNOPSIS jail [-dhi] [-J jid_file] [-l -u username | -U username] [-c | -m] jail [-hi] [-n jailname] [-J jid_file] [-s securelevel] [-l -u username | -U username] [path hostname [ip[,..]] # This is a real pain to play with. So I used the short method like this. It displays the text just as written with no bold and no white boxes. This method is simpler and makes the manpage easier to read without all those white-boxed words. The layout will be the same as what is shown above. .Sh SYNOPSIS .Nm [-dhi] [-J jid_file] [-l -u username | -U username] [-c | -m] .Nm [-hi] [-n jailname] [-J jid_file] [-s securelevel] .Br # this means next line [-l -u username | -U username] [path hostname [ip[,..]] # The description section with the meaning of the flags comes next. .Sh DESCRIPTION The jail utility creates a new jail or modifies an existing jail, imprisoning the current process (and future descendants) inside it. .Pp # blank line position holder. The options are as follows: .Bl -tag -width indent # indent everything that follows. .It Fl d # adds the dash and bolds them both. Allow making changes to a dying jail. .It Fl h # adds the dash and bolds them both. Resolve the host.hostname parameter (or hostname) and add all IP addresses returned by the resolver to the list of ip addresses for this jail. .El # end the indented section. # This is what is displayed by the man command DESCRIPTION The jail utility creates a new jail or modifies an existing jail, optionally imprisoning the current process (and future descendants) inside it. The options are as follows: -d Allow making changes to a dying jail. -h Resolve the host.hostname parameter (or hostname) and add all IP addresses returned by the resolver to the list of ip addresses for this jail. # The short method I used like this. .Sh DESCRIPTION The jail utility creates a new jail or modifies an existing jail, imprisoning the current process (and future descendants) inside it. .Pp # blank line position holder The options are as follows: .Bl -tag -width indent # indent everything that follows .It \fB-d\fR # adds the bold Allow making changes to a dying jail. .It \fB-h\fR # adds the bold Resolve the host.hostname parameter (or hostname) and add all IP addresses returned by the resolver to the list of ip addresses for this jail .El # End the indented section. # This is an example of the special enclosure macro that bolds any word or words its wrapped around. \fB 10.0.10.2 \fR will display as 10.0.10.2 General format notes. The manual standards specify the following sections as mandatory. .Sh NAME .Sh SYNOPSIS .Sh DESCRIPTION Which have been covered all ready. At the end of the manpage there are a few more mandatory sections required in all manpages. .Sh FILES # Section header name in uppercase letters. /usr/local/etc/ezjail.conf .br /usr/local/bin/ezjail .Sh SEE ALSO # Section header name in uppercase letters. .Xr killall 1 , .Xr lsvfs 1 , .Xr newaliases 1 , # or you could just say killall(1), lsvfs(1), newaliases(1) .Sh AUTHORS # Section header name in uppercase letters. .An Tom Jones .Aq tjones@home.com # or you could just use Tom Jones tjones@home.com Now in between the Description section and the FILES section you can make as many sections as you want by using the .Sh macro. Example .Sh USAGE EXAMPLES .Sh HISTORY .Sh BACKGROUND Testing method. I have found it convenient to use 2 sessions for testing. In the F1 session I cycle through these commands gunzip ezjail.8.gz ee ezjail.8 gzip ezjail.8 cp ezjail.8.gz /usr/local/man/man8/ And then from the F2 session I issue man 8 ezjail I can then read my new manpage looking for format, word spacing, sentence wrapping, and verifying that all special bolding is working. Swapping between the edit of the manpage text source on the F1 session and the view of the displayed manpage on the F2 session making any changes to the source as necessary. Then ending the edit, gziping the file and coping it to it’s running location. Where in the F2 session I enter ctlr-c to close the old manpage view and then man 8 ezjail again to view the just update version. I have found that sometimes it’s convenient to render the groff source as pure ascii text. Groff will complain if the raw macro source has blank lines in it and gives you the line number of macros with syntax errors. groff -mdoc -Tascii ezjail.8 | more groff -mdoc -Tascii ezjail.8 > ezjail.raw.text gzcat ezjail.8.gz | groff -mdoc -Tascii | less >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 11:06:08 2010 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B6658106566B for ; Mon, 12 Apr 2010 11:06:08 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9E1728FC16 for ; Mon, 12 Apr 2010 11:06:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3CB68pD041664 for ; Mon, 12 Apr 2010 11:06:08 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3CB67EU041662 for freebsd-doc@FreeBSD.org; Mon, 12 Apr 2010 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 12 Apr 2010 11:06:07 GMT Message-Id: <201004121106.o3CB67EU041662@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 11:06:08 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/145644 doc Add artical about creating manpage from scratch o docs/145631 doc [handbook] References to ttyd0 serial devices in handb o docs/145362 doc [patch] articles/version-guide: russian translation ne o docs/145361 doc [patch] articles/solid-state: russian translation need o docs/145360 doc [patch] articles/releng: russian translation needs to o docs/145359 doc [patch] articles/relaydelay: russian translation needs o docs/145358 doc [patch] articles/problem-reports: russian translation o docs/145357 doc [patch] articles/pr-guidelines: russian translation ne o docs/145356 doc [patch] articles/ipsec-must: russian translation needs o docs/145355 doc [patch] articles/fbsd-from-scratch: russian translatio o docs/145354 doc [patch] articles/checkpoint: russian translation needs o docs/145353 doc [patch] articles/5-roadmap: russian translation needs o docs/145251 doc [patch] iscsi_initiator.4 man page formatting and synt o docs/145227 doc [patch] freebsd-update(8): Update to more recent relea o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145067 doc FAQ remove all reference to floppy installs o docs/145066 doc FAQ update for new uart dev names for serial port. o docs/145059 doc [patch] 7.3 relnotes erroneously describes new ps -p o o docs/145051 doc [patch] missing closing parenthesis in 7.3 relnotes ar o docs/145037 doc [geom] [request] the geom manual sections are sorted i p docs/145031 doc [patch] setkey.8 typo p docs/145030 doc [patch] whitespace fix for sysinstall.8 o docs/145028 doc Handbook Section 2.10.1 Network Device Configuration i o docs/145027 doc Remove all sysinstall references to floppy and slip & o docs/145025 doc Handbook Figure 2-27. Choose Installation Media is out o docs/145023 doc handbook section 2.4 Starting the Installation is outd o docs/145021 doc handbook section 2.3 Pre-installation Tasks is outdate o docs/144986 doc [pf] pf.conf example should show allowing icmp through o docs/144893 doc [handbook] handbook section 18.16.1 Disk Encryption wi o docs/144881 doc [patch][handbook] Reference to incorrect manual page o docs/144880 doc [patch] ipmon(8): Missing BUGS section header o docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc domainname(1) manpage contains old information o docs/144614 doc [patch] [mfi] add IBM ServeRAID M5015 SAS/SATA to list o docs/144543 doc [handbook] IPFW doc change o docs/144537 doc Missing _mdconfig_list and _mdconfig2_list explanation o docs/144534 doc [patch] fdescfs(5) and devfs(5) both provide /dev/fd/{ o docs/144516 doc Remove obsolete sections from handbook o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144498 doc boot(8) should reference uart(4) instead of sio(4) o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/144408 doc [patch] update makefs(8) (remove device option) p docs/144407 doc Duplicate argument entry in mtree(8) o docs/143944 doc strtod(3) mentions "bug noted below" with no such note o docs/143926 doc FAQ entry 16.3 out of date o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143694 doc man8/uathload: the switch -d is mandatory, [] around i o docs/143603 doc error in nanobsd article o docs/143472 doc gethostname(3) references undefined value: HOST_NAME_M o docs/143454 doc [patch] mtree.8 man page errors o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/143342 doc Developer's handbook contains stale information. o docs/143330 doc [patch] strtonum(3) does undocumented clobbering of er o docs/143094 doc [patch] handbook/filesystems: russian translation is m o docs/143041 doc [patch] doc/en__US.ISO8859-1 refers to slip, slirp, sl o docs/142917 doc top(1) man page does not include information about VCS o docs/142437 doc [request] Errata Notices Index missing o docs/142418 doc [PATCH] newfs_msdos(8) doc fix a docs/142341 doc jail(8): Jail escape when cwd is moved from the host s o docs/142243 doc Netcat (nc(1)) manual mistake o docs/142168 doc ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141316 doc ntpd(8): ntpd does not honor -d flag o docs/140918 doc [handbook] update 8.0 handbook about serial port /dev s docs/140847 doc [request] add documentation on ECMP and new route args o docs/140814 doc [handbook][patch] Chapter 15 - Jails: add section on c o docs/140703 doc [patch] add xorg-minimal as alternative for X11 Distri o docs/140495 doc [patch] /etc/rc.conf.d is not documented in rc.conf(5) o docs/140474 doc signal(3) missing reference to NSIG o docs/140458 doc [patch] Grammar fix for to{upper,lower}(3) o docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140435 doc ls(1), section STANDARD: the -A is exception from POSI o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/140369 doc [patch] src/contrib/pf/man/pf.4 o docs/140075 doc release notes: missing word "NOT", which changes all t o docs/139682 doc [PATCH] dialog(1) man page does not mention radiolist o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139153 doc [patch] the hier(7) man page needs to be updated o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138887 doc manpage ports(7) incorrect o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/138206 doc [patch] ntp(1): not enabled function, and false manual o docs/137762 doc [handbook] proposed: mention "make delete-old" in sec o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option p docs/136029 doc MALLOC_PRODUCTION knob should be mentioned somewhere, o docs/135999 doc Netgear GS105v3 should be added to list of switches th o docs/135676 doc FAQ About The FreeBSD Mailing Lists doesn't mention ma o docs/135516 doc pax(1) manual not mentioning chflags unawareness o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/135165 doc [patch] make(1) fixes: punctuation, typos, tweaks o docs/134376 doc pthread(3): pthread manpages don't mention that PTHREA o docs/134226 doc /usr/share/examples/ftpd/ftpd.conf does not exist. o docs/134222 doc installation failure of japanese docs o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/133567 doc [patch] doc/Makefile switch to csup o docs/133245 doc french handbook 27.3.5 amd.map amd.conf o docs/133118 doc [patch] Error in getopt (1) manual EXAMPLES section o docs/132884 doc [request] No manpage for SYSINIT and SYSUNINIT o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132311 doc [patch] man5/nsmb.conf.5 o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/132113 doc [handbook] Update handbook jails creation o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131684 doc [patch] articles/linux-comparison: replace Addenda by o docs/131590 doc [patch] whitespace-only change of developers-handbook/ o docs/130364 doc Man page for top needs explanation of CPU states o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine o docs/128524 doc No geom documentation for loading gjournal(8) s docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/127908 doc [patch] readdir(3) error documentation s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/127253 doc Error in Handbook: http://www.freebsd.org/doc/en/books o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in o docs/125751 doc man 3 pthread_getschedparam section ERRORS incomplete f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121871 doc ftpd does not interpret configuration files as documen o docs/121585 doc [handbook] Wrong multicast specification o docs/121565 doc dhcp-options(5) manpage incorrectly formatted omitting s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120456 doc ath(4) needs to specify requirement on wlan_scan_sta o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting a docs/119536 doc a few typos in French handbook (basics) o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118332 doc man page for top does not describe STATE column wait e o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/117747 doc 'break' system call needs a man page o docs/116480 doc sysctl(3) description of kern.file no longer applies s o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL o docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit o docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/108101 doc /boot/default/loader.conf contains an incorrect commen o docs/107924 doc [usb67] usbd(8) does not call detach o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/101464 doc sync ru_RU.KOI8-R/articles/portbuild/article.html with o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91174 doc [REQUEST] Handbook: Addition of Oracle 9i installation o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/86342 doc bikeshed entry of Handbook is wrong o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/63570 doc [patch] Language cleanup for the Handbook's DNS sectio o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] add documentation on the fixit disk to the FAQ o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 225 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 15:20:01 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8F612106564A for ; Mon, 12 Apr 2010 15:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 527478FC19 for ; Mon, 12 Apr 2010 15:20:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3CFK1ed062748 for ; Mon, 12 Apr 2010 15:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3CFK1wp062747; Mon, 12 Apr 2010 15:20:01 GMT (envelope-from gnats) Resent-Date: Mon, 12 Apr 2010 15:20:01 GMT Resent-Message-Id: <201004121520.o3CFK1wp062747@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Armin Pirkovitsch Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 282D3106567A for ; Mon, 12 Apr 2010 15:10:02 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 1474F8FC1C for ; Mon, 12 Apr 2010 15:10:02 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3CFA1xm047976 for ; Mon, 12 Apr 2010 15:10:01 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3CFA1a4047969; Mon, 12 Apr 2010 15:10:01 GMT (envelope-from nobody) Message-Id: <201004121510.o3CFA1a4047969@www.freebsd.org> Date: Mon, 12 Apr 2010 15:10:01 GMT From: Armin Pirkovitsch To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145655: Add an example to /usr/share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 15:20:01 -0000 >Number: 145655 >Category: docs >Synopsis: Add an example to /usr/share/examples/etc/make.conf >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon Apr 12 15:20:00 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Armin Pirkovitsch >Release: 9.0-CURRENT >Organization: >Environment: >Description: Add an useful example to make.conf to encourage people to look at make(1) to see what else is possible. >How-To-Repeat: >Fix: Patch attached with submission follows: --- make.conf.orig 2010-04-06 17:50:16.000000000 +0200 +++ make.conf 2010-04-12 19:00:45.000000000 +0200 @@ -269,3 +269,15 @@ # /etc/mail/Makefile. Defaults to 0640. # #SENDMAIL_MAP_PERMS= +# +# +# It is also possible to set variables in make.conf which will only be +# used when compiling a eg. specific port. +# For more details have a look at make(1). +# +# Example: +# +#.if ${.CURDIR:M*/irc/irssi-devel*} +#WITH_DEBUG=YES +#.endif +# >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 17:30:05 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 70604106566C for ; Mon, 12 Apr 2010 17:30:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 5F28B8FC08 for ; Mon, 12 Apr 2010 17:30:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3CHU5nD082686 for ; Mon, 12 Apr 2010 17:30:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3CHU5Yn082683; Mon, 12 Apr 2010 17:30:05 GMT (envelope-from gnats) Date: Mon, 12 Apr 2010 17:30:05 GMT Message-Id: <201004121730.o3CHU5Yn082683@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Doug Barton Cc: Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Doug Barton List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 17:30:05 -0000 The following reply was made to PR docs/145655; it has been noted by GNATS. From: Doug Barton To: Armin Pirkovitsch Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf Date: Mon, 12 Apr 2010 10:25:59 -0700 On 4/12/2010 8:10 AM, Armin Pirkovitsch wrote: >> Number: 145655 >> Category: docs >> Synopsis: Add an example to /usr/share/examples/etc/make.conf >> Confidential: no >> Severity: non-critical >> Priority: low >> Responsible: freebsd-doc >> State: open >> Quarter: >> Keywords: >> Date-Required: >> Class: update >> Submitter-Id: current-users >> Arrival-Date: Mon Apr 12 15:20:00 UTC 2010 >> Closed-Date: >> Last-Modified: >> Originator: Armin Pirkovitsch >> Release: 9.0-CURRENT >> Organization: >> Environment: >> Description: > Add an useful example to make.conf to encourage people to look at make(1) to see what else is possible. >> How-To-Repeat: > >> Fix: > > > Patch attached with submission follows: > > --- make.conf.orig 2010-04-06 17:50:16.000000000 +0200 > +++ make.conf 2010-04-12 19:00:45.000000000 +0200 > @@ -269,3 +269,15 @@ > # /etc/mail/Makefile. Defaults to 0640. > # > #SENDMAIL_MAP_PERMS= > +# > +# > +# It is also possible to set variables in make.conf which will only be > +# used when compiling a eg. specific port. > +# For more details have a look at make(1). > +# > +# Example: > +# > +#.if ${.CURDIR:M*/irc/irssi-devel*} > +#WITH_DEBUG=YES > +#.endif > +# IMO it would be more useful to include a pointer to ports/ports-mgmt/portconf. Doug -- ... and that's just a little bit of history repeating. -- Propellerheads Improve the effectiveness of your Internet presence with a domain name makeover! http://SupersetSolutions.com/ From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 19:10:10 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E4997106566C for ; Mon, 12 Apr 2010 19:10:10 +0000 (UTC) (envelope-from olivermahmoudi@gmail.com) Received: from fg-out-1718.google.com (fg-out-1718.google.com [72.14.220.157]) by mx1.freebsd.org (Postfix) with ESMTP id 65BD38FC17 for ; Mon, 12 Apr 2010 19:10:10 +0000 (UTC) Received: by fg-out-1718.google.com with SMTP id l26so410976fgb.13 for ; Mon, 12 Apr 2010 12:10:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:date:received:message-id :subject:from:to:content-type; bh=/cMxyBrNBSt+PO+MZ/5ZKh81yfXmiC9MTBKi7OVOKaU=; b=qFAZP9c3WNZ72RGt8AkfGvR0e7xFc1tP7IeWNLZrejjKZ/Bn9igOfv93+R6zk9cV0p GGiDmMKCUG6+TsqyYLD274GFIk/X8dbGKRp8IFXFU0E3/ATENfn0uf46XJ5chQm1P2sR adBJYu5eoSfgcuLo7oeyfO/XbwOs+M1qcZyp8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type; b=ZWT8/sxA4f+O5Eu5ccKxpsXl2PiwFm8vqVpiyft88AT92ELDIn6p6q3GI+0Jl5Ts34 ohMQL3yAVRKBxZfZBIo01dlXHb9PaFsmm2SaLg121opB2qkmxSnTCFoM47z66hUlGifl 0b45z7YHid6C/lN2w0jy3+F8dLctAlvdhzCmM= MIME-Version: 1.0 Received: by 10.223.124.83 with HTTP; Mon, 12 Apr 2010 11:45:43 -0700 (PDT) Date: Mon, 12 Apr 2010 20:45:43 +0200 Received: by 10.223.15.65 with SMTP id j1mr2861441faa.0.1271097943692; Mon, 12 Apr 2010 11:45:43 -0700 (PDT) Message-ID: From: Oliver Mahmoudi To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: Help Wanted? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 19:10:11 -0000 Hi, Could somebody link me to all the outstanding documents that the FreeBSD Documentation Project is currently servicing? I would be interested in putting some time into helping out, i.e. if help is needed and wanted here. Oliver Mahmoudi From owner-freebsd-doc@FreeBSD.ORG Mon Apr 12 21:05:22 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0A06D106566B for ; Mon, 12 Apr 2010 21:05:22 +0000 (UTC) (envelope-from digitalovrload@aol.com) Received: from imr-ma02.mx.aol.com (imr-ma02.mx.aol.com [64.12.206.40]) by mx1.freebsd.org (Postfix) with ESMTP id A8BB28FC13 for ; Mon, 12 Apr 2010 21:05:21 +0000 (UTC) Received: from mtaout-da03.r1000.mx.aol.com (mtaout-da03.r1000.mx.aol.com [172.29.51.131]) by imr-ma02.mx.aol.com (8.14.1/8.14.1) with ESMTP id o3CKt440019564 for ; Mon, 12 Apr 2010 16:55:04 -0400 Received: from [192.168.24.101] (c-67-190-44-168.hsd1.co.comcast.net [67.190.44.168]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by mtaout-da03.r1000.mx.aol.com (MUA/Third Party Client Interface) with ESMTPSA id 9DC8BE0000BF for ; Mon, 12 Apr 2010 16:55:03 -0400 (EDT) Message-Id: From: Digitalovrload To: "freebsd-doc@freebsd.org" Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (iPod Mail 7E18) Date: Mon, 12 Apr 2010 14:59:48 -0600 X-Mailer: iPod Mail (7E18) x-aol-global-disposition: G X-AOL-SCOLL-SCORE: 0:2:164187312:93952408 X-AOL-SCOLL-URL_COUNT: 0 x-aol-sid: 3039ac1d33834bc388a779b0 X-AOL-IP: 67.190.44.168 Subject: docs/62109: Documentation change request X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Apr 2010 21:05:22 -0000 Lyiliy Sent from my iPod From owner-freebsd-doc@FreeBSD.ORG Tue Apr 13 00:00:10 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9726F106564A for ; Tue, 13 Apr 2010 00:00:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 58A268FC1A for ; Tue, 13 Apr 2010 00:00:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3D00AeR014807 for ; Tue, 13 Apr 2010 00:00:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3D00AJR014799; Tue, 13 Apr 2010 00:00:10 GMT (envelope-from gnats) Resent-Date: Tue, 13 Apr 2010 00:00:10 GMT Resent-Message-Id: <201004130000.o3D00AJR014799@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Warren Block Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 618C3106564A for ; Mon, 12 Apr 2010 23:59:43 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 5194F8FC19 for ; Mon, 12 Apr 2010 23:59:43 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3CNxhZM082805 for ; Mon, 12 Apr 2010 23:59:43 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3CNxhpl082803; Mon, 12 Apr 2010 23:59:43 GMT (envelope-from nobody) Message-Id: <201004122359.o3CNxhpl082803@www.freebsd.org> Date: Mon, 12 Apr 2010 23:59:43 GMT From: Warren Block To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145662: [patch] Porter's Handbook missing semicolon in desktop entries example X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Apr 2010 00:00:10 -0000 >Number: 145662 >Category: docs >Synopsis: [patch] Porter's Handbook missing semicolon in desktop entries example >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Tue Apr 13 00:00:09 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: FreeBSD-8 >Organization: >Environment: FreeBSD lightning 8.0-STABLE FreeBSD 8.0-STABLE #0: Wed Apr 7 17:47:58 MDT 2010 root@lightning:/usr/obj/usr/src/sys/LIGHTNING i386 >Description: Porter's Handbook DESKTOP_ENTRIES example is missing a semicolon after the last category ("Application;Game;RolePlaying") but ports structure requires semicolons after each category. >How-To-Repeat: Compare DESKTOP_ENTRIES example in Porter's Handbook to the real entry in the actual port (/usr/ports/games/tome/Makefile): Example: "Application;Game;RolePlaying" Actual: "Application;Game;RolePlaying;" >Fix: Apply attached patch to Porter's Handbook book.sgml. Patch attached with submission follows: --- book.sgml.orig 2010-04-12 17:45:24.000000000 -0600 +++ book.sgml 2010-04-12 17:46:59.000000000 -0600 @@ -5409,7 +5409,7 @@ DESKTOP_ENTRIES= "ToME" "Roguelike game based on JRR Tolkien's work" \ "${DATADIR}/xtra/graf/tome-128.png" \ - "tome -v -g" "Application;Game;RolePlaying" \ + "tome -v -g" "Application;Game;RolePlaying;" \ false >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Apr 14 13:30:01 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CC74D1065679 for ; Wed, 14 Apr 2010 13:30:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8F3C08FC1D for ; Wed, 14 Apr 2010 13:30:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3EDU1Am015346 for ; Wed, 14 Apr 2010 13:30:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3EDU1E0015343; Wed, 14 Apr 2010 13:30:01 GMT (envelope-from gnats) Resent-Date: Wed, 14 Apr 2010 13:30:01 GMT Resent-Message-Id: <201004141330.o3EDU1E0015343@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Garrett Cooper Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 05217106564A for ; Wed, 14 Apr 2010 13:20:34 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id E893E8FC24 for ; Wed, 14 Apr 2010 13:20:33 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3EDKXR0064670 for ; Wed, 14 Apr 2010 13:20:33 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3EDKX1v064669; Wed, 14 Apr 2010 13:20:33 GMT (envelope-from nobody) Message-Id: <201004141320.o3EDKX1v064669@www.freebsd.org> Date: Wed, 14 Apr 2010 13:20:33 GMT From: Garrett Cooper To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145699: hexdump(1) mutes all format qualifier output following a %_Ax declaration X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Apr 2010 13:30:01 -0000 >Number: 145699 >Category: docs >Synopsis: hexdump(1) mutes all format qualifier output following a %_Ax declaration >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Wed Apr 14 13:30:01 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Garrett Cooper >Release: 9-CURRENT >Organization: Cisco Systems, Inc. >Environment: FreeBSD bayonetta.local 9.0-CURRENT FreeBSD 9.0-CURRENT #4 r206173M: Mon Apr 12 07:16:16 PDT 2010 root@bayonetta.local:/usr/obj/usr/src/sys/BAYONETTA amd64 >Description: The problem with the %_A qualifier is that it doesn't match the expectations delivered in the documentation don't reflect reality: $ echo -n "$(jot -b a 8193)" | hexdump -v -e '"%07.7_Ax\n" /1 "%s"' 0004001 I would expect 8193 "a"s to be printed, like so: $ echo -n "$(jot -b a 8193)" | hexdump -v -e '"%07.7_Ax\n" /1 "%s"' # ... a a a a a a a a a a a a 0004001 $ Obviously %_A isn't being evaluated at the end and is being evaluated in order of the expressions which are defined on the command line // in a file. Thus the example in the manpage is broken :(... >How-To-Repeat: echo "$(jot -b a 8193)" | ./hexdump -v -e '"%.7_Ax\n" /1 "%s"' >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Apr 14 17:20:03 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3EE971065670 for ; Wed, 14 Apr 2010 17:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 14D948FC14 for ; Wed, 14 Apr 2010 17:20:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3EHK2o4012131 for ; Wed, 14 Apr 2010 17:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3EHK2td012128; Wed, 14 Apr 2010 17:20:02 GMT (envelope-from gnats) Date: Wed, 14 Apr 2010 17:20:02 GMT Message-Id: <201004141720.o3EHK2td012128@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Armin Pirkovitsch Cc: Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Armin Pirkovitsch List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Apr 2010 17:20:03 -0000 The following reply was made to PR docs/145655; it has been noted by GNATS. From: Armin Pirkovitsch To: Doug Barton Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf Date: Wed, 14 Apr 2010 19:19:23 +0200 On Mon 12 Apr 2010, Doug Barton wrote: > On 4/12/2010 8:10 AM, Armin Pirkovitsch wrote: > >> Number: 145655 > >> Category: docs > >> Synopsis: Add an example to /usr/share/examples/etc/make.conf > >> Confidential: no > >> Severity: non-critical > >> Priority: low > >> Responsible: freebsd-doc > >> State: open > >> Quarter: > >> Keywords: > >> Date-Required: > >> Class: update > >> Submitter-Id: current-users > >> Arrival-Date: Mon Apr 12 15:20:00 UTC 2010 > >> Closed-Date: > >> Last-Modified: > >> Originator: Armin Pirkovitsch > >> Release: 9.0-CURRENT > >> Organization: > >> Environment: > >> Description: > > Add an useful example to make.conf to encourage people to look at make(1) to see what else is possible. > >> How-To-Repeat: > > > >> Fix: > > > > > > Patch attached with submission follows: > > > > --- make.conf.orig 2010-04-06 17:50:16.000000000 +0200 > > +++ make.conf 2010-04-12 19:00:45.000000000 +0200 > > @@ -269,3 +269,15 @@ > > # /etc/mail/Makefile. Defaults to 0640. > > # > > #SENDMAIL_MAP_PERMS= > > +# > > +# > > +# It is also possible to set variables in make.conf which will only be > > +# used when compiling a eg. specific port. > > +# For more details have a look at make(1). > > +# > > +# Example: > > +# > > +#.if ${.CURDIR:M*/irc/irssi-devel*} > > +#WITH_DEBUG=YES > > +#.endif > > +# > > IMO it would be more useful to include a pointer to > ports/ports-mgmt/portconf. > > > Doug I would suggest to include it additional to the already proposed content - that way people can choose whether to use a port or simply make.conf itself for it. Armin From owner-freebsd-doc@FreeBSD.ORG Wed Apr 14 18:10:07 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 554B11065674 for ; Wed, 14 Apr 2010 18:10:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 25AA58FC16 for ; Wed, 14 Apr 2010 18:10:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3EIA3p9054173 for ; Wed, 14 Apr 2010 18:10:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3EIA3OQ054172; Wed, 14 Apr 2010 18:10:03 GMT (envelope-from gnats) Date: Wed, 14 Apr 2010 18:10:03 GMT Message-Id: <201004141810.o3EIA3OQ054172@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Doug Barton Cc: Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Doug Barton List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Apr 2010 18:10:07 -0000 The following reply was made to PR docs/145655; it has been noted by GNATS. From: Doug Barton To: Armin Pirkovitsch Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf Date: Wed, 14 Apr 2010 11:06:12 -0700 On 4/14/2010 10:19 AM, Armin Pirkovitsch wrote: > On Mon 12 Apr 2010, Doug Barton wrote: > >> IMO it would be more useful to include a pointer to >> ports/ports-mgmt/portconf. >> >> >> Doug > > I would suggest to include it additional to the already proposed content > - that way people can choose whether to use a port or simply make.conf > itself for it. That's fine as long as the text doesn't become so confusing as to be unhelpful. :) Doug -- ... and that's just a little bit of history repeating. -- Propellerheads Improve the effectiveness of your Internet presence with a domain name makeover! http://SupersetSolutions.com/ From owner-freebsd-doc@FreeBSD.ORG Wed Apr 14 18:50:02 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A1C2E1065677 for ; Wed, 14 Apr 2010 18:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 77BE08FC1A for ; Wed, 14 Apr 2010 18:50:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3EIo2rW089666 for ; Wed, 14 Apr 2010 18:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3EIo2W5089665; Wed, 14 Apr 2010 18:50:02 GMT (envelope-from gnats) Date: Wed, 14 Apr 2010 18:50:02 GMT Message-Id: <201004141850.o3EIo2W5089665@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Armin Pirkovitsch Cc: Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Armin Pirkovitsch List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Apr 2010 18:50:02 -0000 The following reply was made to PR docs/145655; it has been noted by GNATS. From: Armin Pirkovitsch To: Doug Barton Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/145655: Add an example to /usr/share/examples/etc/make.conf Date: Wed, 14 Apr 2010 20:44:13 +0200 --IJpNTDwzlM2Ie8A6 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline My suggestion would be the attached patch. However I'm not really the person who writes great and/or understandable documentations. Armin --IJpNTDwzlM2Ie8A6 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="patch-examples-etc-make.txt" --- make.conf.orig 2010-04-14 17:05:26.000000000 +0200 +++ make.conf 2010-04-14 20:39:58.000000000 +0200 @@ -269,3 +269,18 @@ # /etc/mail/Makefile. Defaults to 0640. # #SENDMAIL_MAP_PERMS= +# +# +# It is also possible to set variables in make.conf which will only be +# used when compiling e.g. a specific port. +# For more details have a look at make(1). +# +# Example: +# +#.if ${.CURDIR:M*/irc/irssi-devel*} +#WITH_DEBUG=YES +#.endif +# +# Another approach to do this is by using the port ports-mgmt/portconf +# which uses its own config file for port specific options. +# --IJpNTDwzlM2Ie8A6-- From owner-freebsd-doc@FreeBSD.ORG Thu Apr 15 10:30:02 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E98BA1065670 for ; Thu, 15 Apr 2010 10:30:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id AA1B88FC21 for ; Thu, 15 Apr 2010 10:30:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3FAU18Z027689 for ; Thu, 15 Apr 2010 10:30:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3FAU1WW027687; Thu, 15 Apr 2010 10:30:01 GMT (envelope-from gnats) Resent-Date: Thu, 15 Apr 2010 10:30:01 GMT Resent-Message-Id: <201004151030.o3FAU1WW027687@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, pluknet Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 636E81065674 for ; Thu, 15 Apr 2010 10:24:16 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 53A4B8FC12 for ; Thu, 15 Apr 2010 10:24:16 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3FAOGBN050828 for ; Thu, 15 Apr 2010 10:24:16 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3FAOFa0050815; Thu, 15 Apr 2010 10:24:15 GMT (envelope-from nobody) Message-Id: <201004151024.o3FAOFa0050815@www.freebsd.org> Date: Thu, 15 Apr 2010 10:24:15 GMT From: pluknet To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145719: [patch] 7.3 relnotes erroneously describes new getpagesizes(3) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Apr 2010 10:30:02 -0000 >Number: 145719 >Category: docs >Synopsis: [patch] 7.3 relnotes erroneously describes new getpagesizes(3) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Apr 15 10:30:01 UTC 2010 >Closed-Date: >Last-Modified: >Originator: pluknet >Release: FreeBSD 7.3 >Organization: >Environment: >Description: The getpagesize(3) library call already exists since 4.2BSD (according to its manpage), so this is wrong. Should be corrected to getpagesizes(3) - that's what really appeared in 7.3 with r203170. The original text below. &os; libc library now includes &man.getpagesize.3; function that returns either the number of page sizes supported by the system or a specified subset of the supported page sizes. >How-To-Repeat: >Fix: I guess the next (or similar) should go to the Errata page (attached). [My English is not native, please review if my articles are correct]. Patch attached with submission follows: Index: release/doc/en_US.ISO8859-1/errata/article.sgml =================================================================== --- release/doc/en_US.ISO8859-1/errata/article.sgml (revision 206651) +++ release/doc/en_US.ISO8859-1/errata/article.sgml (working copy) @@ -167,6 +167,19 @@ Late-Breaking News and Corrections + [20100415] The &os; 7.3-RELEASE Release Notes incorrectly + mentioned that the &man.getpagesize.3 function has been added + to &os; libc library. It should have + been the &man.getpagesizes.3 function. The correct entry + is: + +
+ &os; libc library now includes + &man.getpagesizes.3; function that returns either the number + of page sizes supported by the system or a specified subset of + the supported page sizes. +
+ [20100402] The &os; 7.3-RELEASE Release Notes incorrectly mentioned that a flag has been added to the &man.ps.1; utility. It should have been a >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Apr 16 13:30:04 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 78528106564A for ; Fri, 16 Apr 2010 13:30:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4D7E98FC1A for ; Fri, 16 Apr 2010 13:30:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3GDU4q2043052 for ; Fri, 16 Apr 2010 13:30:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3GDU4VH043049; Fri, 16 Apr 2010 13:30:04 GMT (envelope-from gnats) Date: Fri, 16 Apr 2010 13:30:04 GMT Message-Id: <201004161330.o3GDU4VH043049@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: pluknet Cc: Subject: Re: docs/145059: [patch] 7.3 relnotes erroneously describes new ps -p option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: pluknet List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Apr 2010 13:30:04 -0000 The following reply was made to PR docs/145059; it has been noted by GNATS. From: pluknet To: bug-followup@FreeBSD.org, pluknet@gmail.com Cc: Subject: Re: docs/145059: [patch] 7.3 relnotes erroneously describes new ps -p option Date: Fri, 16 Apr 2010 17:22:07 +0400 So, that one can be closed now. -- wbr, pluknet From owner-freebsd-doc@FreeBSD.ORG Sat Apr 17 15:05:21 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A19FF1065673; Sat, 17 Apr 2010 15:05:21 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 78C2D8FC12; Sat, 17 Apr 2010 15:05:21 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3HF5LMW095621; Sat, 17 Apr 2010 15:05:21 GMT (envelope-from linimon@freefall.freebsd.org) Received: (from linimon@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3HF5LuN095617; Sat, 17 Apr 2010 15:05:21 GMT (envelope-from linimon) Date: Sat, 17 Apr 2010 15:05:21 GMT Message-Id: <201004171505.o3HF5LuN095617@freefall.freebsd.org> To: pluknet@gmail.com, linimon@FreeBSD.org, freebsd-doc@FreeBSD.org From: linimon@FreeBSD.org Cc: Subject: Re: docs/145059: [patch] 7.3 relnotes erroneously describes new ps -p option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Apr 2010 15:05:21 -0000 Synopsis: [patch] 7.3 relnotes erroneously describes new ps -p option State-Changed-From-To: open->closed State-Changed-By: linimon State-Changed-When: Sat Apr 17 15:05:00 UTC 2010 State-Changed-Why: apparently has been committed. http://www.freebsd.org/cgi/query-pr.cgi?pr=145059 From owner-freebsd-doc@FreeBSD.ORG Sat Apr 17 23:20:01 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8B7541065673 for ; Sat, 17 Apr 2010 23:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6613D8FC1F for ; Sat, 17 Apr 2010 23:20:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o3HNK1j1017215 for ; Sat, 17 Apr 2010 23:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o3HNK1MV017214; Sat, 17 Apr 2010 23:20:01 GMT (envelope-from gnats) Resent-Date: Sat, 17 Apr 2010 23:20:01 GMT Resent-Message-Id: <201004172320.o3HNK1MV017214@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, tnfhmwkq Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B8EE1106566B for ; Sat, 17 Apr 2010 23:11:57 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 8F8968FC13 for ; Sat, 17 Apr 2010 23:11:57 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o3HNBvS3086779 for ; Sat, 17 Apr 2010 23:11:57 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o3HNBv3b086778; Sat, 17 Apr 2010 23:11:57 GMT (envelope-from nobody) Message-Id: <201004172311.o3HNBv3b086778@www.freebsd.org> Date: Sat, 17 Apr 2010 23:11:57 GMT From: tnfhmwkq To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/145790: tnfhmwkq X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Apr 2010 23:20:01 -0000 >Number: 145790 >Category: docs >Synopsis: tnfhmwkq >Confidential: no >Severity: critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Sat Apr 17 23:20:01 UTC 2010 >Closed-Date: >Last-Modified: >Originator: tnfhmwkq >Release: tnfhmwkq >Organization: tnfhmwkq >Environment: tnfhmwkq >Description: amhpomeh http://uvgucoqo.com fqhiaaan pmasxwwz wrolofns [URL=http://axhxlrnu.com]xoihrweb[/URL] >How-To-Repeat: tnfhmwkq >Fix: tnfhmwkq >Release-Note: >Audit-Trail: >Unformatted: