From owner-freebsd-doc Sun Aug 22 2:44: 0 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix13.ix.netcom.com (dfw-ix13.ix.netcom.com [206.214.98.13]) by hub.freebsd.org (Postfix) with ESMTP id 034BC154FF; Sun, 22 Aug 1999 02:43:55 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix13.ix.netcom.com (8.8.4/8.8.4) id EAA14582; Sun, 22 Aug 1999 04:43:47 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix13.ix.netcom.com via smap (V1.3) id rma014578; Sun Aug 22 04:43:38 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id CAA01764; Sun, 22 Aug 1999 02:43:34 -0700 (PDT) To: Nik Clayton Cc: doc@freebsd.org Subject: Re: Default FDP docs installation directory? References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 22 Aug 1999 02:43:33 -0700 In-Reply-To: Nik Clayton's message of "Thu, 19 Aug 1999 13:12:24 +0100" Message-ID: Lines: 72 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Nik Clayton * I am, to say the least, somewhat surprised at the amount of mail this issue * threw up, particularly the tone of some of the mail. I've seen this * happen on some of the other lists (-committers, -current, and cvs-* in * particular) and I don't really want it to happen on the -doc list. I don't like it either, but you've got many people so mad it's quite understandable. :) * I get the impression that some -doc subscribers have the wrong idea about * what it is that I'm doing as the Doc. Proj. Manager, and what my role * actually is. : * But in doing this, I'm no different from any other contributor to this list * (well, every contributor that's also a committer, and I'm pleased to report * that the number of FDP related committers is growing nicely at the moment). So you are not the one that makes the decisions when people don't agree? That's good to hear. :) I had the distinct impression that you are the manager that we need to convince, and you are a very hard person to convince once you make up your mind (which is usually very early). I guess I was wrong. * To try and illustrate this, lets look at three different examples from the * relatively recent past: There's another one. You converted the documents from Linuxdoc to Docbook, arguing it's better. Honestly, I still don't see why it was necessary. The few documents I care about (handbook's ports chapter) is much harder to read in HTML after the conversion with all the numbers gone from the section headers. The sgml files are harder to edit too, but that might be because we've been using Linuxdoc for a long time. Also, the Japanese PS and PDF handbook generation is still broken since the Linuxdoc -> Docbook switchover. Is anyone going to fix that? I'm not saying you should fix it, but since you are the one that proposed the switch and the one that implemented it, you should at least make sure you have someone signed up to fix it (ideally before the switchover). * One thing that should be made clear -- just because it was committed as * such does not mean (and should never mean) that I'm not flexible in * changing it at the first opportunity as necessary. That's good to hear. But to avoid any further misunderstandings, please don't commit things if it's already surrounded by controversy. * For the future, I'm going to try and make sure that my suggestions are * marked as such (and not "commandments handed down from the Doc. Proj. * Manager"), so that they're less likely to cause what seems to have been * some offense. Then it might help if you don't post messages with subjects like: Resolution: FDP reorganisation right when the discussion started. That's called pushing the wrong button. Then there's the matter of trust (as a human being). Honestly, there is very little trust in you, especially among the Japanese people. I asked you twice about who in the Japanese translation team you talked to about the FAQ Docbook conversion. Will you please answer my question? If I don't get an answer this time, I will assume you lied the first time around and in fact didn't talk to anybody on the Japanese team. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 3: 3:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.cdrom.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 79F7F14D62; Sun, 22 Aug 1999 03:03:18 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.cdrom.com (8.9.3/8.9.3) with ESMTP id DAA01175; Sun, 22 Aug 1999 03:03:22 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) To: asami@FreeBSD.ORG (Satoshi - Ports Wraith - Asami) Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: Default FDP docs installation directory? In-reply-to: Your message of "22 Aug 1999 02:43:33 PDT." Date: Sun, 22 Aug 1999 03:03:22 -0700 Message-ID: <1171.935316202@localhost> From: "Jordan K. Hubbard" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Erm, I really don't like to see this kind of thing... People who both do good work ripping into one another leaves the audience rather unsure of how to react, and those being ripped into don't much enjoy the experience either. I think this has all come about through misunderstanding rather than malice and if people are getting "angry" then they already need to go take walks before coming back and attempting to communicate in public. We are all experienced enough to know the poor results generated by angry posts. Nik has just put in a large amount of work here and I would like to just return our attention to that fact for a moment while those who don't like his methods attempt to make it sound as if there was nothing good about the conversion or reorganization work. There was a lot of necessary work done here, from both a tools and a content standpoint, and if the look-and-feel isn't spot-on the first iteration or two, well, that's easily evolved. I'm also sure that Nik has no intention of leaving tools for formating the various translations broken, considering how much work he's put into packaging the translations in a more flexible fashion lately. I think this is simply yet another communications break-down, perhaps on both sides, and there's no reason to accuse Nik of lying or otherwise being anything but *confused* about how much communication had or had not occurred. Just knowing how much dust has had to be blown out of the Handbook and FAQ documents lately (and still remains to be blown out), I'd say anybody with enough guts to really start reorganizing our completely dysfunctional docset deserves kudos, not rocks. - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 3: 7:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix14.ix.netcom.com (dfw-ix14.ix.netcom.com [206.214.98.14]) by hub.freebsd.org (Postfix) with ESMTP id E77B214D62; Sun, 22 Aug 1999 03:07:38 -0700 (PDT) (envelope-from asami@cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix14.ix.netcom.com (8.8.4/8.8.4) id FAA26527; Sun, 22 Aug 1999 05:06:24 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix14.ix.netcom.com via smap (V1.3) id rma026524; Sun Aug 22 05:06:16 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id DAA01904; Sun, 22 Aug 1999 03:06:12 -0700 (PDT) Date: Sun, 22 Aug 1999 03:06:12 -0700 (PDT) Message-Id: <199908221006.DAA01904@silvia.hip.berkeley.edu> X-Authentication-Warning: silvia.hip.berkeley.edu: asami set sender to asami@cs.berkeley.edu using -f To: nik@freebsd.org Cc: doc@freebsd.org In-reply-to: (asami@freebsd.org) Subject: Re: Default FDP docs installation directory? From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) * Then it might help if you don't post messages with subjects like: * * Resolution: FDP reorganisation * * right when the discussion started. That's called pushing the wrong * button. Also, just to show that it's not only the title that gives out the impression that you are the one that's making decisions, here are some sentences from that mail of yours: === Heads up, the FDP directory change should be happening this weekend. After talking with John Polstra, it was decided that the wholesale repository copies and moves within doc/ that I had originally requested were infeasible due to the scale of the request. So we've changed how it's going to be done. : At some point this weekend (to be decided by CVS Rep. Manager John Polstra) the doc/ repository will be frozen. It will then be moved aside, and a new doc/ repository created. : And after comments from the Japanese Doc. Proj., the directory for Japanese docs in the repository will be ja_JP.EUC-JP. : === This is a mail handing down decisions, not one asking for comments. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 3:40:57 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix15.ix.netcom.com (dfw-ix15.ix.netcom.com [206.214.98.15]) by hub.freebsd.org (Postfix) with ESMTP id 9575414E6C; Sun, 22 Aug 1999 03:40:44 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix15.ix.netcom.com (8.8.4/8.8.4) id FAA22854; Sun, 22 Aug 1999 05:39:55 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix15.ix.netcom.com via smap (V1.3) id rma022852; Sun Aug 22 05:39:42 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id DAA02007; Sun, 22 Aug 1999 03:39:36 -0700 (PDT) To: "Jordan K. Hubbard" Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: Default FDP docs installation directory? References: <1171.935316202@localhost> From: asami@FreeBSD.ORG (Satoshi - Ports Wraith - Asami) Date: 22 Aug 1999 03:39:35 -0700 In-Reply-To: "Jordan K. Hubbard"'s message of "Sun, 22 Aug 1999 03:03:22 -0700" Message-ID: Lines: 91 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: "Jordan K. Hubbard" Let me state first that I really appreciate Nik for cleaning up the documents, handling PRs about docs, etc. I have no problem with that part of what he's doing. I also admire his courage to tackle a very hard problem, that is redesigning the doc system. * Erm, I really don't like to see this kind of thing... People who both Trust me, I don't like it very much either. I would very much like to stay out of this and pretend nothing is happening, especially since I'm not that involved in the Japanese translations anymore. But I read the grumblings in the Japanese mailing lists from those who have to do the actual work, and can't help but notice that they've been yanked around by chains for months. The Japanese doc team has been forced to do a lot of extra work because of all these conversion and reorganization work. Just tonight I tried to fix the japanese/handbook port and gave up after I couldn't get it to work after a few iterations of ja -> ja_JP.eucJP, en -> en_US.ISO_8859-1 type substitutions. That makes me think, why do I have to do this? When I do a massive reorganization in the ports tree, I make sure I fix things that break myself or at least sign up people I can trust who will fix it quickly after I change something. Most of the time, the changes go through at least a couple of iterations of full package builds to make sure everything works ok. That's part of being a manager on a volunteer project. If he doesn't want to do this, that's fine, but then he shouldn't be making decisions. * do good work ripping into one another leaves the audience rather * unsure of how to react, and those being ripped into don't much enjoy * the experience either. I think this has all come about through * misunderstanding rather than malice and if people are getting "angry" * then they already need to go take walks before coming back and * attempting to communicate in public. We are all experienced enough to * know the poor results generated by angry posts. People have been perpetually angry, that's all. It's past the "walks" stage. :) * Nik has just put in a large amount of work here and I would like to * just return our attention to that fact for a moment while those who * don't like his methods attempt to make it sound as if there was * nothing good about the conversion or reorganization work. There was a * lot of necessary work done here, from both a tools and a content * standpoint, and if the look-and-feel isn't spot-on the first iteration * or two, well, that's easily evolved. I'm also sure that Nik has no * intention of leaving tools for formating the various translations * broken, considering how much work he's put into packaging the * translations in a more flexible fashion lately. I hope I'll see evidence to support your point soon. Right now I honestly can't say the doc tree (especially the Japanese part) is in better shape than before. * I think this is simply yet another communications break-down, perhaps * on both sides, and there's no reason to accuse Nik of lying or * otherwise being anything but *confused* about how much communication * had or had not occurred. I asked him something and he gave me quite an explicit answer. Maybe he was confused. Then why didn't he didn't clalify that point when I requested names, I have no idea. * Just knowing how much dust has had to be * blown out of the Handbook and FAQ documents lately (and still remains * to be blown out), I'd say anybody with enough guts to really start * reorganizing our completely dysfunctional docset deserves kudos, not * rocks. I agree in principle, but if the reorganization leaves things in a state worse than before, when there has been a large amount of controversy surrounding the reorganization in the first place, does that still hold true? Also, the thing that really pushed me over the edge is that Nik claims he's only one of us and is not the "manager" that people think he is. This has been patently false as far as I can tell, and it's really unfair to label those who oppose him as Don Quixotes fighting an imaginary dragon. Oh, and please don't tell me to go take a walk. I've sat on the previous e-mail for 2 days, even playing golf (now that's a long walk) in the process. It didn't change my opinion. :) Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 6:40:10 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 632931550E; Sun, 22 Aug 1999 06:40:06 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18344.on.bellglobal.com (ppp18382.on.bellglobal.com [206.172.130.62]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id JAA06127; Sun, 22 Aug 1999 09:41:24 -0400 (EDT) Received: (from tim@localhost) by ppp18344.on.bellglobal.com (8.9.3/8.9.1) id JAA48128; Sun, 22 Aug 1999 09:41:33 -0400 (EDT) (envelope-from tim) Date: Sun, 22 Aug 1999 09:41:32 -0400 From: Tim Vanderhoek To: Satoshi - Ports Wraith - Asami Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990822094132.C47976@ppp18344.on.bellglobal.com> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 02:43:33AM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Aug 22, 1999 at 02:43:33AM -0700, Satoshi - Ports Wraith - Asami wrote: > > numbers gone from the section headers. The sgml files are harder to > edit too, but that might be because we've been using Linuxdoc for a > long time. Yes; picking markup tags in Linuxdoc is much easier. You just run your text through a random markup generator. Let me write in DocBook any day. A real reference manual, for one. LinuxDoc rather reminds me of our old GNU binutils. [The plan to convert to DocBook has been around longer than Nik's been around, so don't forget that the conversion wasn't even his idea]. -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 12:19:48 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 94B531556D; Sun, 22 Aug 1999 12:19:42 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id UAA72078; Sun, 22 Aug 1999 20:12:33 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id KAA89669; Sun, 22 Aug 1999 10:58:22 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Sun, 22 Aug 1999 10:58:22 +0100 From: Nik Clayton To: Chris Costello Cc: Nik Clayton , "Jordan K. Hubbard" , Kris Kennaway , doc@freebsd.org Subject: Re: FAQ only for FreeBSD 2.x? Message-ID: <19990822105822.A89333@kilt.nothing-going-on.org> References: <19990818200721.A49279@catkin.nothing-going-on.org> <81306.935014109@localhost> <19990818204557.A99464@holly.dyndns.org> <19990819131806.B844@kilt.nothing-going-on.org> <19990820204309.B1366@holly.dyndns.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990820204309.B1366@holly.dyndns.org>; from Chris Costello on Fri, Aug 20, 1999 at 08:43:09PM -0500 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Aug 20, 1999 at 08:43:09PM -0500, Chris Costello wrote: > On Thu, Aug 19, 1999, Nik Clayton wrote: > > Is there a list of known issues with it being maintained by anyone at > > the moment? As I go through it doing the markup changes I'm going to > > Not that I know of, no. OK, what's the FAQ team address (freebsd-faq@freebsd.org?). Next week is going to be a week of going through the FAQ correcting the markup (unless someone else desperately wants to do this -- if you do, speak up now) and I'll keep notes on any information I see that's either definitely wrong, might be wrong, or needs investigating. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 12:22:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 8597A14C7F; Sun, 22 Aug 1999 12:22:28 -0700 (PDT) (envelope-from hoek@FreeBSD.org) Received: (from hoek@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id MAA74824; Sun, 22 Aug 1999 12:21:54 -0700 (PDT) (envelope-from hoek@FreeBSD.org) Date: Sun, 22 Aug 1999 12:21:54 -0700 (PDT) From: Message-Id: <199908221921.MAA74824@freefall.freebsd.org> To: sobomax@altavista.net, hoek@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13310: [PATCH] Man pages typos and inconsistencies... Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: [PATCH] Man pages typos and inconsistencies... State-Changed-From-To: open->closed State-Changed-By: hoek State-Changed-When: Sun Aug 22 12:21:37 PDT 1999 State-Changed-Why: Patches applied, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 15:17:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 82796155F6; Sun, 22 Aug 1999 15:15:41 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id WAA87731; Sun, 22 Aug 1999 22:14:07 +0100 (BST) (envelope-from nik) Date: Sun, 22 Aug 1999 22:14:07 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990822221406.A80051@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 02:43:33AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ I'd dearly, dearly love to be able to say that I've redirected all followups to this message to the freebsd-navel-gazing list. Unfortunately, we don't have one, so it's stuck here in -doc. I'd quite like to take this to personal e-mail, but I can hear the chants of "Why won't he discuss this in public? FreeBSD is too cliquey, we want to know what's going on!" ringing in my ears, so I haven't. My apologies. But, if you're reading this for the humour value, take my advice and go straight to the last page -- there's a corker waiting for you. ] On Sun, Aug 22, 1999 at 02:43:33AM -0700, Satoshi - Ports Wraith - Asami wrote: > * I get the impression that some -doc subscribers have the wrong idea about > * what it is that I'm doing as the Doc. Proj. Manager, and what my role > * actually is. > : > * But in doing this, I'm no different from any other contributor to this list > * (well, every contributor that's also a committer, and I'm pleased to report > * that the number of FDP related committers is growing nicely at the moment). > > So you are not the one that makes the decisions when people don't > agree? That's good to hear. :) That depends :-) I'm trying hard not to have to make specific decisions, because I'm trying to make sure that there's enough discussion that the right choice falls out of the discussion. As I said in the previous message, some times there are no obvious right or wrong choices to make, and it's only when people start asking questions in the discussion that pointers to the right answer come up. Having said that, I get personal e-mail every day from people who read -doc, both committers and non-committers, asking whether they should do 'x' or 'y', and I answer them as best I can. Where possible I cc: my replies back to -doc so that (1) my response gets in the archives, and (2) people who might know more about it than I do can respond if they see the message. Sometimes I can't answer the question at all, and just point them at people who I hope can answer the question. And I imagine that one day there will be two committers who both want to commit different variants on the same change, and I'll get asked to choose between them. But as I say, I'll try and *not* say "Do it this way!", but I'll ask questions about both approaches to see if one way is better than another. > I had the distinct impression that you are the manager that we need to > convince, and you are a very hard person to convince once you make up > your mind (which is usually very early). I guess I was wrong. Yeah. I don't normally take a lot of convincing if something's a bad idea. Take the "/usr/local/share/doc/fdp/" thing. That was discussed, and turned around in roughly 24 hours. *24* hours. That's practically no time at all, particularly when I do all my e-mail reading in blocks of time that are roughly 12 hours apart. (i.e., at t+0 I post the message, at t+12 the first responses have come in, some making points that I'd considered, which I responded to countering those points, some making points that I hadn't considered, and I start thinking "Hmm, maybe this isn't such a great idea", and t+24 more responses have come in, almost all of them pointing out problems, and I drop the idea.) Notice, incidentally, that I don't just drop the idea, but I say so publically, and in a message to the list, which means that this all gets archived. I'm not interested in trying to hide mistakes that I might have made. > * To try and illustrate this, lets look at three different examples from the > * relatively recent past: > > There's another one. You converted the documents from Linuxdoc to > Docbook, arguing it's better. Honestly, I still don't see why it was > necessary. These are in no particular order of significance; 1. LinuxDoc is dying. SGMLTools, the main 'wrapper' around it in the Linux world has switched to DocBook, and the Linux Documentation Project is moving towards it (although not as quickly as we have -- this is mostly because we have less documentation to convert). 2. DocBook is a far better designed DTD. Yes, there's more to learn about it (which is why I wrote, and continue to write, the primer), but it's more extensible, more flexible and more widely supported. 3. DocBook as a DTD promotes consistency in the choice of markup. This is a good thing, as it (a) makes the job of marking things up easier, (b) allows more consistency in the output, giving a strong sense of 'family' between the documents, (c) prevents the author having to worry about what their document will look like, and instead concentrate on marking up their documentation accurately. 4. DocBook is a "richer" markup model, so our documents will be easier to downgrade to other markup models (like, for example, HTML, or PilotDoc). There are others, and I suspect that there's about to be slew of messages from DocBook supporters, so I'll wait and see what points they make, before following up with anything they've missed. > The few documents I care about (handbook's ports chapter) > is much harder to read in HTML after the conversion with all the > numbers gone from the section headers. Edit freebsd.dsl, and put this code fragment; (define %section-autolabel% ;; Are sections enumerated? #t) somewhere between the markers. Then take two aspirin and call me in the morning if the problem persists. If people think that should go in freebsd.dsl shipped by the FDP then say so -- I'm agnostic about the issue, but if people want it in then it can go in. What you're describing is an issue with the formatting, which is (unlike LinuxDoc) much removed from the markup language itself. Yours is the first time I can recall seeing anyone on this list mention this as being a problem -- note that I'm not saying it's the first time anyone's mentioned it, but it's the first time I've noticed it as a problem. > The sgml files are harder to edit too, but that might be because we've > been using Linuxdoc for a long time. Harder to edit how? You've got a consistent set of indentation for the first time, making it much easier to see the structure of the document? And if you mean that DocBook is hard because you don't know DocBook then I'd appreciate comments on the Primer so that I can improve it for people. > Also, the Japanese PS and PDF handbook generation is still broken > since the Linuxdoc -> Docbook switchover. It is? Define broken? I know that there were problems, but I was under the impression that Jun Kuriyama had fixed them, updated the port, and forwarded them on to Norm Walsh. > Is anyone going to fix that? They will if you let me know what they are. A quick % cd /usr/gnats/docs % grep dsssl * didn't show up anything, so I guess people don't care enough to send in a PR about it. I can't fix stuff (or at least, investigate) stuff I don't know about. > I'm not saying you should fix it, but since you are the one > that proposed the switch and the one that implemented it, you should > at least make sure you have someone signed up to fix it (ideally > before the switchover). It's obviously escaped your attention, but I am doing stuff to fix it. People commented that they didn't like the way the FAQ was coming out. I had a patch back to the list within 12 hours or so -- so far, just one person has bothered to comment on it. Since they said they liked it, it's gone in to my queue of things to commit -- it'll take a few days, because I've mailed my patch back to the original author for comments, because I'm not convinced my patch is the right way to do it. > * One thing that should be made clear -- just because it was committed as > * such does not mean (and should never mean) that I'm not flexible in > * changing it at the first opportunity as necessary. > > That's good to hear. But to avoid any further misunderstandings, > please don't commit things if it's already surrounded by controversy. At that point it wasn't surrounded by controversy. > * For the future, I'm going to try and make sure that my suggestions are > * marked as such (and not "commandments handed down from the Doc. Proj. > * Manager"), so that they're less likely to cause what seems to have been > * some offense. > > Then it might help if you don't post messages with subjects like: > > Resolution: FDP reorganisation > > right when the discussion started. That's called pushing the wrong > button. I think you might have a loose SIMM somewhere. The "Resolution" message was posted after we'd already had one long round of discussion on the topic, and two posted drafts of the plan for doing it. I thought that after the amount of time it had been discussed every objection had either been discussed, and realised that it wasn't a problem, or discussed, and incorporated in to the plan. It was only after the "Resolution" message was posted that a set of fresh problems and concerns were raised. More specifically: my first message was posted on 4th May (subject line was "doc//books/*, doc//articles/*, and docs.freebsd.org". That discussion had 4 distinct contributors, and carried on until the 15th May. It slowed down over the last two days, so on May 13th I posted a revised version of the plan, with the subject line "FDP Directory Reorganisation". People seemed to wake up at this point, and we carried on until June 26th. During that discussion I was amending and posting amendments to the plan as we went along, and as with the previous discussion, it petered out towards the end, which is why I posted the "Resolution" message in June 23rd. You might think that a message posted in June 23rd to a discussion that was kick-started on the 4th May is "right when the discussion started", but I've got a hard time following that train of thought I'm afraid. This thread devolved in to three main discussions: 1. The first was about the name of the Japanese directory. I'd mistakenly thought that the Japanese consensus was for ja_JP.EUC-JP. You bought the fact that I'd made a mistake about this to my attention, and I immediately changed it the ja_JP.eucJP you requested. That's a non-issue. 2. The merits of repository copies, whether or not commit histories needed to be maintained, and the tags. I was quite happy to let this discussion carry on without much input from me -- I didn't completely follow the points the Japanese team were making, didn't have much time to, but trusted that between yourselves and JDP you would come to an arrangement. As far as I can tell, it was all resolved amicably. 3. The third, and by far longest sub-thread was sparked by Motoyuki Konno, who asked why we were doing this at all. This then triggered a re-run of large chunks of the two earlier threads on this, with the same arguments back and forth. > Then there's the matter of trust (as a human being). Honestly, there > is very little trust in you, especially among the Japanese people. Christ, I've offended a whole nation :-) OK, seriously, for a moment: if you felt the need to write that then something has gone seriously wrong. I'd like to hear from the members of the Japanese Doc. Proj. (in private mail please, not withstanding the disclaimer at the start of this message, I don't think we need to subject -doc to the rest of this) so we can discuss this a little more slowly and a little more calmly. I mean no offense to you Satoshi, but until this little blow-up my contact with the Japanese translators was Jun Kuriyama, and he's been conspicuously absent from this thread. I'm also going to commit the third cardinal sin of e-mail discussion netiquette: I've had private mail from members of a couple of the other translation teams asking me what the hell is going on here, and why are we getting so uptight about this, so there's at least some remnants of trust left lying around. > I asked you twice about who in the Japanese translation team you talked > to about the FAQ Docbook conversion. Will you please answer my > question? Sorry for the delay. Going through 7.8MB of outgoing mail file takes some time, particularly when you have to spend so much of that time writing long and involved e-mails to mailing lists because some people just won't let some issues wither and die. Jun Kuriyama, personal e-mail, subject line "Re: FDP Directory Reorganisation", message ID <19990607235712.A35217@catkin.nothing-going-on.org> It was in one message to Jun, talking about plans for after the conversion. With hindsight I think it's clear how Jun could have ignored it, or put it on the "to think about later" pile, and not got around to it. The error is still mine. > If I don't get an answer this time, I will assume you lied the first > time around and in fact didn't talk to anybody on the Japanese team. I love comments like this in e-mail. It always leaves the recipient in such a dilemma. Should I delete it, and pretend I never saw it? Should I rise to the bait, start foaming at the mouth, and flame you with 15 screenfulls of invective? Should I instead try and pick it apart, refute it at length, bore the audience with carefully argued debate. Should I just make fun of it? I just can't decide. Tell you what, since this is the new happy, shiny, FDP organisation, where consensus rules, I'll throw this one out to the assembled masses. Hey guys, if you're reading this, and you've got a strong opinion as to which of the options above I should take (or if you've got a new one) please e-mail me directly and let me know. I'll summarise the responses back to the list (unless, of course, most of the responses are "No, please, stop talking about this, we're very bored of it, and would just like to get on writing some documentation in peace and quiet please."). Cheers, N PS: Oh, one more thing. I'm going to be over for FreeBSD Con. in October, and I understand that some of the Japanese translation team are going to be there as well -- could we maybe postpone this whole thing until we can sit down and talk about it face to face? I'm a lovely guy in person, willing to stand my own round of drinks, and I can probably bore you all with pictures of my girlfriend. PPS: I wonder if there's any statistical correlation between the fluctuation in length of my e-mail messages and the times that my girlfriend spends on holiday. PPPS: OK, seriously for a moment again. "Jun Kuriyama". Am I right in using "Jun" in the same way other people would refer to me as "Nik", or have I got it backwards? I've asked about this before, but I think it got lost in the noise, and the last time the topic came up (on another mailing list as it happens) I don't recall any clear consensus -- thanks. -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 15:20:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 8C4AE155D0; Sun, 22 Aug 1999 15:15:41 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id WAA92763; Sun, 22 Aug 1999 22:55:21 +0100 (BST) (envelope-from nik) Date: Sun, 22 Aug 1999 22:55:21 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: "Jordan K. Hubbard" , Nik Clayton , doc@FreeBSD.ORG Subject: Re: Default FDP docs installation directory? Message-ID: <19990822225520.A73959@catkin.nothing-going-on.org> References: <1171.935316202@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 03:39:35AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello again Satoshi. My apologies once more to the members of -doc. On Sun, Aug 22, 1999 at 03:39:35AM -0700, Satoshi - Ports Wraith - Asami wrote: > Trust me, I don't like it very much either. I would very much like to > stay out of this and pretend nothing is happening, especially since > I'm not that involved in the Japanese translations anymore. > > But I read the grumblings in the Japanese mailing lists from those who > have to do the actual work, and can't help but notice that they've > been yanked around by chains for months. Am I reading this right, or are you not actually speaking for the Japanese doc team at the moment. If you are, then that's fine. But if you're not, I'd like to stress again that I'd really, really, *really* like to hear from the Japanese team, and in particular from Jun Kuriyama. > The Japanese doc team has been forced to do a lot of extra work > because of all these conversion and reorganization work. In case it's escaped your notice, so has the English, Spanish, Russian, and Chinese teams. And the French team has been waiting in the wings for something like 6 months now waiting for this work to be completed before I pull in their translations -- I didn't want to bring in a large chunk of newly translated docs immediately before a big repository change, as it's needless bloat. This is manifestly *not* the Japanese team being forced to do a lot of work that none of the other teams have to do, and at no point in the discussion that preceeded the change (to the best of my knowledge) did anyone from *any* of the translation teams stand up and say Sorry, can we postpone this change please. We haven't got the manpower to dedicate to it right now. One message like that from any of the translation teams would have been enough to stop the repo change dead in its tracks. > Just tonight I tried to fix the japanese/handbook port and gave up after > I couldn't get it to work after a few iterations of ja -> ja_JP.eucJP, en -> > en_US.ISO_8859-1 type substitutions. That makes me think, why do I > have to do this? Good question. Possibly because it's part of ports/, and you're the ports wraith. I seem to recall various kludges and workarounds going in to some of the doc/ Makefiles to try and detect when some of the > When I do a massive reorganization in the ports tree, I make sure I > fix things that break myself or at least sign up people I can trust > who will fix it quickly after I change something. Most of the time, > the changes go through at least a couple of iterations of full package > builds to make sure everything works ok. Sounds about right. > That's part of being a manager on a volunteer project. If he doesn't > want to do this, that's fine, but then he shouldn't be making > decisions. Uh, Satoshi, I am doing it. I built and rebuilt the docs numerous times on my local system and on freefall. I posted several requests for people to download the latest trees and give them a hammering on their system before I unfroze the tree and turned the website building back on. I've spent God alone knows how much time writing the e-mails and the plans for this. I wrote the FDP Project Primer, which is there exactly because I wasn't going to do the conversion without ensuring there was good documentation backing it up. That's 94 pages of documentation right there. Where did you think it came from? I'm writing the DaemonNews articles that are slowly demistifying the doc/ and www/ make(1) Makefiles. I'm proposing and encouraging new committers to the FDP, one of whom is shortly going to commit his SGML'ed "Committers Guide" to the tree, so that life is made even easier for new committers. I'm answering stupid questions from people about how they get sections in the HTML output to be numbered. Getting new software to work on FreeBSD is quite a sexy job, with lots of plaudits for those people that do it. Writing and maintaining the documentation and the infrastructure for that documentation is much less exciting work. I'm not about to start arguing about which of the ports teams and the doc teams do more work, but I am 100% satisfied in my mind that we pull our weight, thanks. > * do good work ripping into one another leaves the audience rather > * unsure of how to react, and those being ripped into don't much enjoy > * the experience either. I think this has all come about through > * misunderstanding rather than malice and if people are getting "angry" > * then they already need to go take walks before coming back and > * attempting to communicate in public. We are all experienced enough to > * know the poor results generated by angry posts. > > People have been perpetually angry, that's all. I haven't had an angry e-mail from Jun Kuriyama yet. I'm sitting here with a lop-sided grin on my face wondering what on Earth you're going to come up with next. > * Nik has just put in a large amount of work here and I would like to > * just return our attention to that fact for a moment while those who > * don't like his methods attempt to make it sound as if there was > * nothing good about the conversion or reorganization work. There was a > * lot of necessary work done here, from both a tools and a content > * standpoint, and if the look-and-feel isn't spot-on the first iteration > * or two, well, that's easily evolved. I'm also sure that Nik has no > * intention of leaving tools for formating the various translations > * broken, considering how much work he's put into packaging the > * translations in a more flexible fashion lately. > > I hope I'll see evidence to support your point soon. Right now I > honestly can't say the doc tree (especially the Japanese part) is in > better shape than before. It's in about the same shape as before -- I'd say it's a little better than it was, but only marginally. However, we have almost all the LinuxDoc docs out of the tree (the Russian FAQ hasn't been converted yet, it's a mechanical job, and if I don't see patches to do it soon I'll get on to it, and there are two English primers that haven't been converted). We have a build system that massively reduces its reliance on the files in src/share/mk/, and will become even more separate from that shortly. We have the beginnings of infrastructure in place to support making packages of all the documentation, in all the languages. This will simplify "make release" considerably, although probably not in time for the 3.3 candidate. We have the beginnings of XML support ready to go in to the doc/ tree. We have people working on a proper, extensible, DocBook -> *roff converter, something that people on other mailing lists have been clamouring after for years. We have people actively jumping at the chance to maintain the FAQ, which is a pleasant change. Yes, we've just expended a lot of energy to go from one position to what looks like being a very similar position. But the view from our new position is radically different. > * I think this is simply yet another communications break-down, perhaps > * on both sides, and there's no reason to accuse Nik of lying or > * otherwise being anything but *confused* about how much communication > * had or had not occurred. > > I asked him something and he gave me quite an explicit answer. Maybe > he was confused. Then why didn't he didn't clalify that point when I > requested names, I have no idea. Lack of time. Here's an average day. 7.00am Get up 7.05am Start downloading the overnight mail 7.10am Jump in the shower 7.40am Leave for work, with laptop, carrying last nights mail 7.50am On train. Spend ~ 1 hour researching and replying to mail/code 9-13.00pm Work 13.00pm Lunch. Spend more time researching and replying to mail/code 14-18.30pm Work. 18.30pm Travel home. More mail/code 19.30pm Collapse for an hour or so 20.30pm Upload the replies written during the day, commit changes written during the day. 2.00am (Yes, really) Sleep On Tuesday's I play badminton (badly, but it gets me out of the house), Thursday nights are social drinking nights, and weekends are claimed by my girlfriend (unless she's away). That's probably more detail than you really wanted. But if you can see a space in there for "Grovel through 7.8MB of mail looking for one specific message written some time ago" I'd like to see it. So yes, sometimes it takes me a while to reply. And yes, sometimes, I might not put enough detail in to the messages that I write -- I've noted this comment, and I'm working on acting on it. But, you'll all be happy to know that there'll be considerably less e-mail emanating from this part of the world in the very near future, as I fully expect co-authoring "Teach Yourself FreeBSD in 21 Days" for Macmillan will take up a great deal of my e-mail time. But rest assured I'll make the time to devote to the FDP. > Also, the thing that really pushed me over the edge is that Nik claims > he's only one of us and is not the "manager" that people think he is. > This has been patently false as far as I can tell, and it's really > unfair to label those who oppose him as Don Quixotes fighting an > imaginary dragon. I'm striving desperately for analogies here. In an earlier message I listed a long group of people in the FreeBSD project that I'm not. I might have been wrong about that, and, if you'll forgive the hubris, perhaps my role is (or certainly should be) more akin to David Greenman's architect role. From what I've seen David is more than happy to delegate work out to those people that actually want to do the work, and rarely needs to get involved directly (I could well be understating David's involvement here, I don't follow the lists he haunts too closely, but it's been a while since I saw a commit message with "dg" in it). Obviously I haven't got the balance of David's personality traits yet, but, then again, he's got a few years on me. That architectural role is perhaps a better fit for what I'm trying to do here. How does the following patch to handbook/staff/chapter.sgml strike everyone? Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/staff/chapter.sgml,v retrieving revision 1.55 diff -u -1 -r1.55 chapter.sgml --- chapter.sgml 1999/08/11 13:53:13 1.55 +++ chapter.sgml 1999/08/22 21:51:28 @@ -698,3 +698,3 @@ - Documentation Project Manager + Documentation Project Architect > Oh, and please don't tell me to go take a walk. I've sat on the > previous e-mail for 2 days, even playing golf (now that's a long walk) > in the process. It didn't change my opinion. :) Golf? Try horse riding. Then you can join Jordan, myself, and anyone else interested, if we manage to go for a trek during FreeBSD Con. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 15:25:34 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id A878D14FB9; Sun, 22 Aug 1999 15:25:29 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id XAA96788; Sun, 22 Aug 1999 23:24:19 +0100 (BST) (envelope-from nik) Date: Sun, 22 Aug 1999 23:24:18 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: nik@freebsd.org, doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990822232418.A96331@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <199908221006.DAA01904@silvia.hip.berkeley.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908221006.DAA01904@silvia.hip.berkeley.edu>; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 03:06:12AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Aug 22, 1999 at 03:06:12AM -0700, Satoshi - Ports Wraith - Asami wrote: > Also, just to show that it's not only the title that gives out the > impression that you are the one that's making decisions, here are some > sentences from that mail of yours: > > === > Heads up, the FDP directory change should be happening this weekend. > > After talking with John Polstra, it was decided that the wholesale > repository copies and moves within doc/ that I had originally > requested were infeasible due to the scale of the request. So we've > changed how it's going to be done. > : > At some point this weekend (to be decided by CVS Rep. Manager John Polstra) > the doc/ repository will be frozen. It will then be moved aside, and a > new doc/ repository created. > : > And after comments from the Japanese Doc. Proj., the directory for > Japanese docs in the repository will be ja_JP.EUC-JP. > : > === > > This is a mail handing down decisions, not one asking for comments. Satoshi, that message was sent after a month's worth of discussion, and two prior posted plans. I was under the impression that I was documenting the consensus that had been reached during that discussion. As events proved, my impression was wrong, and I was quick to correct that when the Japanese team pointed it out. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 16: 9:15 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sand4.global.net.uk (sand4.global.net.uk [194.126.80.248]) by hub.freebsd.org (Postfix) with ESMTP id 7A1CA154D5 for ; Sun, 22 Aug 1999 16:09:08 -0700 (PDT) (envelope-from mark@globalnet.co.uk) Received: from pfds10a06.client.global.net.uk ([195.147.218.254] helo=marder-1.) by sand4.global.net.uk with esmtp (Exim 2.12 #1) id 11Iggj-0001l3-00 for doc@freebsd.org; Mon, 23 Aug 1999 00:06:09 +0100 Received: (from mark@localhost) by marder-1. (8.9.2/8.8.8) id XAA01099 for doc@freebsd.org; Sun, 22 Aug 1999 23:59:11 +0100 (BST) (envelope-from mark) Date: Sun, 22 Aug 1999 23:59:11 +0100 From: Mark Ovens To: doc@freebsd.org Subject: How to build DocBook docs? Message-ID: <19990822235910.F271@marder-1> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.3i Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Are there any instructions anywhere on building the new (DocBook) docs? I can build the LinuxDoc ones OK, but the DocBook ones just generates lots of errors from jade, like: cannot open "/usr/local/share/sgml/docbook/dsssl/modular/catalog" (No such file or directory) DTD did not contain element declaration for document type name element "BOOK" undefined etc, etc. Thanks. -- STATE-OF-THE-ART: Any computer you can't afford. OBSOLETE: Any computer you own. ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 23: 7:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from icc.surw.chel.su (surw.chel.su [195.54.2.162]) by hub.freebsd.org (Postfix) with ESMTP id EA7B015636; Sun, 22 Aug 1999 23:06:54 -0700 (PDT) (envelope-from andy@icc.surw.chel.su) Received: (from andy@localhost) by icc.surw.chel.su (8.9.2/8.8.8) id KAA33521; Mon, 23 Aug 1999 10:06:25 +0400 (MSD) (envelope-from andy) From: Andrey Zakhvatov Message-Id: <199908230606.KAA33521@icc.surw.chel.su> Subject: Re: docs/13103: Update doc: doc/ru/FAQ/preface.sgml In-Reply-To: <199908172119.OAA72357@freefall.freebsd.org> from "nik@FreeBSD.org" at "Aug 17, 1999 2:19:54 pm" To: nik@FreeBSD.org Date: Mon, 23 Aug 1999 10:06:25 +0400 (MSD) Cc: freebsd-doc@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL43 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, > Synopsis: Update doc: doc/ru/FAQ/preface.sgml > > State-Changed-From-To: open->closed > State-Changed-By: nik > State-Changed-When: Tue Aug 17 14:19:38 PDT 1999 > State-Changed-Why: > Committed, thanks. Sorry, but it looks like that patch was not committed :( Sincerely yours, Andy -- Tel: +7-(3512)-38-39-73, E-mail: andy@icc.surw.chel.su WWW: http://surw.chel.su/~andy/index.html, ICQ:10705306 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 23: 8:34 1999 Delivered-To: freebsd-doc@freebsd.org Received: from icc.surw.chel.su (surw.chel.su [195.54.2.162]) by hub.freebsd.org (Postfix) with ESMTP id 8827014D9C; Sun, 22 Aug 1999 23:08:21 -0700 (PDT) (envelope-from andy@icc.surw.chel.su) Received: (from andy@localhost) by icc.surw.chel.su (8.9.2/8.8.8) id KAA33564; Mon, 23 Aug 1999 10:08:17 +0400 (MSD) (envelope-from andy) From: Andrey Zakhvatov Message-Id: <199908230608.KAA33564@icc.surw.chel.su> Subject: Re: docs/13101: Update doc: doc/ru/FAQ/kernelconfig.sgml In-Reply-To: <199908171822.LAA57515@freefall.freebsd.org> from "nik@FreeBSD.org" at "Aug 17, 1999 11:22:20 am" To: nik@FreeBSD.org Date: Mon, 23 Aug 1999 10:08:16 +0400 (MSD) Cc: freebsd-doc@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL43 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, > Synopsis: Update doc: doc/ru/FAQ/kernelconfig.sgml > > State-Changed-From-To: open->closed > State-Changed-By: nik > State-Changed-When: Tue Aug 17 11:21:42 PDT 1999 > State-Changed-Why: > Committed, thanks. Sorry, but it looks like that patch was not committed :( Sincerely yours, Andy -- Tel: +7-(3512)-38-39-73, E-mail: andy@icc.surw.chel.su WWW: http://surw.chel.su/~andy/index.html, ICQ:10705306 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 23:11: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from icc.surw.chel.su (surw.chel.su [195.54.2.162]) by hub.freebsd.org (Postfix) with ESMTP id E105414D10; Sun, 22 Aug 1999 23:10:58 -0700 (PDT) (envelope-from andy@icc.surw.chel.su) Received: (from andy@localhost) by icc.surw.chel.su (8.9.2/8.8.8) id KAA33612; Mon, 23 Aug 1999 10:10:51 +0400 (MSD) (envelope-from andy) From: Andrey Zakhvatov Message-Id: <199908230610.KAA33612@icc.surw.chel.su> Subject: Re: docs/13094: Update doc: doc/ru/FAQ/acknowledgments.sgml In-Reply-To: <199908171807.LAA55973@freefall.freebsd.org> from "nik@FreeBSD.org" at "Aug 17, 1999 11: 7:43 am" To: nik@FreeBSD.org Date: Mon, 23 Aug 1999 10:10:50 +0400 (MSD) Cc: freebsd-doc@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL43 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, > Synopsis: Update doc: doc/ru/FAQ/acknowledgments.sgml > > State-Changed-From-To: open->closed > State-Changed-By: nik > State-Changed-When: Tue Aug 17 11:07:16 PDT 1999 > State-Changed-Why: > Committed, thanks. Sincerely yours, Andy -- Tel: +7-(3512)-38-39-73, E-mail: andy@icc.surw.chel.su WWW: http://surw.chel.su/~andy/index.html, ICQ:10705306 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Aug 22 23:12:42 1999 Delivered-To: freebsd-doc@freebsd.org Received: from icc.surw.chel.su (surw.chel.su [195.54.2.162]) by hub.freebsd.org (Postfix) with ESMTP id BACC014D10; Sun, 22 Aug 1999 23:12:26 -0700 (PDT) (envelope-from andy@icc.surw.chel.su) Received: (from andy@localhost) by icc.surw.chel.su (8.9.2/8.8.8) id KAA33637; Mon, 23 Aug 1999 10:11:27 +0400 (MSD) (envelope-from andy) From: Andrey Zakhvatov Message-Id: <199908230611.KAA33637@icc.surw.chel.su> Subject: Re: docs/13094: Update doc: doc/ru/FAQ/acknowledgments.sgml In-Reply-To: <199908171807.LAA55973@freefall.freebsd.org> from "nik@FreeBSD.org" at "Aug 17, 1999 11: 7:43 am" To: nik@FreeBSD.org Date: Mon, 23 Aug 1999 10:11:27 +0400 (MSD) Cc: freebsd-doc@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL43 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, > Synopsis: Update doc: doc/ru/FAQ/acknowledgments.sgml > > State-Changed-From-To: open->closed > State-Changed-By: nik > State-Changed-When: Tue Aug 17 11:07:16 PDT 1999 > State-Changed-Why: > Committed, thanks. Sorry, but it looks like that patch was not committed :( Sincerely yours, Andy -- Tel: +7-(3512)-38-39-73, E-mail: andy@icc.surw.chel.su WWW: http://surw.chel.su/~andy/index.html, ICQ:10705306 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 2:58:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 1DEF9155DC for ; Mon, 23 Aug 1999 02:58:08 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 8738 invoked by uid 1003); 23 Aug 1999 09:59:00 -0000 Date: Mon, 23 Aug 1999 11:59:00 +0200 From: Neil Blakey-Milner To: doc@FreeBSD.org Subject: Some proposed changes in expectation of obj'able doc makes Message-ID: <19990823115900.A6290@rucus.ru.ac.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi I generated a set of patches to teach the doc building process to work properly should we have an existant obj directory, but for the old doc mindset, and I'm working on recreating them for the new. Currently, in Makefiles all around we have statements like: DOC_PREFIX?= ../../.. I propose we change all of them to: DOC_PREFIX?= ${.CURDIR}/../../.. Also, we have a whole bunch of: .include "../../../share/sgml/docproj.docbook.mk" which I think should become: .include "${DOC_PREFIX}/share/sgml/docproj.docbook.mk" I'm not a make expert, but could we achieve it by: .PATH: ${DOC_PREFIX}/share/sgml .include "docproj.docbook.mk" That might make things easier for doc generation without the whole tree? In any case, I'll generate the patchset and send it in when I'm on my own time. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 3:35:49 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix4.ix.netcom.com (dfw-ix4.ix.netcom.com [206.214.98.4]) by hub.freebsd.org (Postfix) with ESMTP id 766B914CF5 for ; Mon, 23 Aug 1999 03:35:47 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix4.ix.netcom.com (8.8.4/8.8.4) id FAA13634; Mon, 23 Aug 1999 05:34:53 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix4.ix.netcom.com via smap (V1.3) id rma013631; Mon Aug 23 05:34:33 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id DAA06952; Mon, 23 Aug 1999 03:34:15 -0700 (PDT) To: Neil Blakey-Milner Cc: doc@FreeBSD.org Subject: Re: Some proposed changes in expectation of obj'able doc makes References: <19990823115900.A6290@rucus.ru.ac.za> From: asami@FreeBSD.org (Satoshi - Ports Wraith - Asami) Date: 23 Aug 1999 03:34:12 -0700 In-Reply-To: Neil Blakey-Milner's message of "Mon, 23 Aug 1999 11:59:00 +0200" Message-ID: Lines: 10 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Neil Blakey-Milner * I generated a set of patches to teach the doc building process to work * properly should we have an existant obj directory, but for the old doc * mindset, and I'm working on recreating them for the new. That is real great to hear, I'd been wanting it for months. Many thanks in advance! Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 4:10: 6 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id D9BE61565D; Mon, 23 Aug 1999 04:10:05 -0700 (PDT) (envelope-from chris@FreeBSD.org) Received: (from chris@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA50170; Mon, 23 Aug 1999 04:09:56 -0700 (PDT) (envelope-from chris@FreeBSD.org) Date: Mon, 23 Aug 1999 04:09:56 -0700 (PDT) From: Message-Id: <199908231109.EAA50170@freefall.freebsd.org> To: phantom@cris.net, chris@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13290: [PATCH] ktrace.2 does not described ENOSYS error. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: [PATCH] ktrace.2 does not described ENOSYS error. State-Changed-From-To: open->closed State-Changed-By: chris State-Changed-When: Mon Aug 23 04:09:25 PDT 1999 State-Changed-Why: Committed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 5:41: 7 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 057E1156D7 for ; Mon, 23 Aug 1999 05:41:06 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id FAA56491; Mon, 23 Aug 1999 05:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id ED1FE156A0; Mon, 23 Aug 1999 05:37:03 -0700 (PDT) Message-Id: <19990823123703.ED1FE156A0@hub.freebsd.org> Date: Mon, 23 Aug 1999 05:37:03 -0700 (PDT) From: sobomax@altavista.net To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/13330: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13330 >Category: docs >Synopsis: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd >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 Aug 23 05:40:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Maxim Sobolev >Release: 4.0-CURRENT >Organization: Vega International Capital >Environment: Doesn't matter >Description: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd. From notes.sgml: o With the contribution of Berkeley Software Design, Inc., Jonathan Lemmon, Mike Smith, Sean Eric Fagan, and John Dyson, VM86 support has been added to the kernel, and BSD/OS's contributed dosemu has been ported. ^^^^^^ - obviously doscmd was mentioned here . >How-To-Repeat: Point your browser to http://www.freebsd.org/releases/3.0R/notes.html ;) >Fix: >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 6:21:59 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id C13CD15438 for ; Mon, 23 Aug 1999 06:21:54 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id GAA59920; Mon, 23 Aug 1999 06:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id EC3FE14F68 for ; Mon, 23 Aug 1999 06:17:25 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 89334 invoked by uid 1003); 23 Aug 1999 13:16:47 -0000 Message-Id: <19990823131647.89333.qmail@rucus.ru.ac.za> Date: 23 Aug 1999 13:16:47 -0000 From: nbm@rucus.ru.ac.za Reply-To: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13331: www/docproj/translations.sgml has errors Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13331 >Category: docs >Synopsis: www/docproj/translations.sgml has errors >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Aug 23 06:20:02 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Neil Blakey-Milner >Release: FreeBSD 3.0-STABLE i386 >Organization: Rhodes University Computer Users' Society >Environment: FreeBSD rucus.ru.ac.za 3.0-STABLE FreeBSD 3.0-STABLE #0: Tue Feb 9 22:52:23 GMT 1999 grahams@rucus.ru.ac.za:/usr/src/sys/compile/RUCUS-SMP i386 >Description: (nbm@rucus) /home/build/nbm/www/en/docproj> make translations.orig.html sgmlnorm -d -c /usr/local/share/sgml/html/catalog translations.orig.sgml > tran slations.orig.html sgmlnorm:translations.orig.sgml:59:224:E: end tag for element "A" which is not o pen sgmlnorm:translations.orig.sgml:60:214:E: end tag for element "A" which is not o pen sgmlnorm:translations.orig.sgml:70:218:E: end tag for element "A" which is not o pen *** Error code 1 Stop. >How-To-Repeat: See above. >Fix: Index: translations.sgml =================================================================== RCS file: /home/ncvs/www/en/docproj/translations.sgml,v retrieving revision 1.26 diff -u -r1.26 translations.sgml --- translations.sgml 1999/08/22 04:59:47 1.26 +++ translations.sgml 1999/08/23 12:35:44 @@ -56,8 +56,8 @@ Web: http://www.freebsd-fr.org
Mailing lists available
-
Send a mail to listserver@freebsd-fr.org with the words "SUB freebsd-questions" in the body of the message for subscribing to the questions mailing list in French.
-
Send a mail to listserver@freebsd-fr.org with the words "SUB annonces" in the body of the message for subscribing to the announce mailing list in French.
+
Send a mail to listserver@freebsd-fr.org with the words "SUB freebsd-questions" in the body of the message for subscribing to the questions mailing list in French.
+
Send a mail to listserver@freebsd-fr.org with the words "SUB annonces" in the body of the message for subscribing to the announce mailing list in French.
Documents available
FAQ
Some tutorials
@@ -67,7 +67,7 @@
Handbook
CVS repository
CVS web
-
Send a mail to listserver@freebsd-fr.org with the words "SUB cvs" in the body of the message for subscribing to the French CVS update mailing list in French.
+
Send a mail to listserver@freebsd-fr.org with the words "SUB cvs" in the body of the message for subscribing to the French CVS update mailing list in French.
>Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 6:41:54 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 51C881575E for ; Mon, 23 Aug 1999 06:41:40 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id GAA62417; Mon, 23 Aug 1999 06:40:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Mon, 23 Aug 1999 06:40:03 -0700 (PDT) Message-Id: <199908231340.GAA62417@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Neil Blakey-Milner Subject: Re: docs/13330: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd Reply-To: Neil Blakey-Milner Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13330; it has been noted by GNATS. From: Neil Blakey-Milner To: sobomax@altavista.net Cc: freebsd-gnats-submit@FreeBSD.ORG Subject: Re: docs/13330: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd Date: Mon, 23 Aug 1999 15:30:03 +0200 > o With the contribution of Berkeley Software Design, Inc., Jonathan Lemmon, > Mike Smith, Sean Eric Fagan, and John Dyson, VM86 support has been added > to the kernel, and BSD/OS's contributed dosemu has been ported. > ^^^^^^ - obviously doscmd was mentioned here . > >How-To-Repeat: > Point your browser to http://www.freebsd.org/releases/3.0R/notes.html ;) cvs diff: Diffing . Index: notes.sgml =================================================================== RCS file: /home/ncvs/www/en/releases/3.0R/notes.sgml,v retrieving revision 1.4 diff -u -r1.4 notes.sgml --- notes.sgml 1998/12/01 02:59:36 1.4 +++ notes.sgml 1999/08/23 13:28:53 @@ -148,7 +148,7 @@ o With the contribution of Berkeley Software Design, Inc., Jonathan Lemmon, Mike Smith, Sean Eric Fagan, and John Dyson, VM86 support has been added - to the kernel, and BSD/OS's contributed dosemu has been ported. + to the kernel, and BSD/OS's contributed doscmd has been ported. o The SA_NOCLDWAIT flags has been implemented, featuring the System V option where a process can express its wish to never get zombies or To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 6:43:32 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 60ABB157AE for ; Mon, 23 Aug 1999 06:41:03 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id NAA02735; Mon, 23 Aug 1999 13:48:38 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 13:48:38 +0100 From: Nik Clayton To: Mark Ovens Cc: doc@freebsd.org Subject: Re: How to build DocBook docs? Message-ID: <19990823134838.A2121@catkin.nothing-going-on.org> References: <19990822235910.F271@marder-1> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990822235910.F271@marder-1>; from Mark Ovens on Sun, Aug 22, 1999 at 11:59:11PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Aug 22, 1999 at 11:59:11PM +0100, Mark Ovens wrote: > Are there any instructions anywhere on building the new (DocBook) > docs? I can build the LinuxDoc ones OK, but the DocBook ones just > generates lots of errors from jade, like: > > cannot open "/usr/local/share/sgml/docbook/dsssl/modular/catalog" (No such file or directory) Take a look in /var/db/pkg, and pkg_delete(1) anything you have installed with "docbook" in the package name (docbook-*, and dsssl-docbook-* probably). Then # cd /usr/ports/textproc # cd docbook # make install # cd ../dsssl-docbook-modular # make install That should fix it. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 6:44:37 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id D6A6E14E04 for ; Mon, 23 Aug 1999 06:41:03 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA04594; Mon, 23 Aug 1999 14:03:32 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 14:03:32 +0100 From: Nik Clayton To: Neil Blakey-Milner Cc: doc@FreeBSD.org Subject: Re: Some proposed changes in expectation of obj'able doc makes Message-ID: <19990823140332.C2121@catkin.nothing-going-on.org> References: <19990823115900.A6290@rucus.ru.ac.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990823115900.A6290@rucus.ru.ac.za>; from Neil Blakey-Milner on Mon, Aug 23, 1999 at 11:59:00AM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Neil, On Mon, Aug 23, 1999 at 11:59:00AM +0200, Neil Blakey-Milner wrote: > I generated a set of patches to teach the doc building process to work > properly should we have an existant obj directory, but for the old doc > mindset, and I'm working on recreating them for the new. > > Currently, in Makefiles all around we have statements like: > > DOC_PREFIX?= ../../.. > > I propose we change all of them to: > > DOC_PREFIX?= ${.CURDIR}/../../.. I'm sure this is a good idea. At least, it looks like a good idea, and it looks similar to the mechanism used in the src/ Makefiles, and I assume it's a good idea there as well. But what does it actually do? Would you (or anyone else on the list) be able to write up a description of what the benefits are, and how they work? This can then be added to the FDP primer, so that newcomers to the project have something they can read through which explains things like this? Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 6:45:40 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 3C55715CE1; Mon, 23 Aug 1999 06:41:03 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id NAA03568; Mon, 23 Aug 1999 13:55:11 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 13:55:11 +0100 From: Nik Clayton To: Andrey Zakhvatov Cc: nik@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13103: Update doc: doc/ru/FAQ/preface.sgml Message-ID: <19990823135511.B2121@catkin.nothing-going-on.org> References: <199908172119.OAA72357@freefall.freebsd.org> <199908230606.KAA33521@icc.surw.chel.su> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908230606.KAA33521@icc.surw.chel.su>; from Andrey Zakhvatov on Mon, Aug 23, 1999 at 10:06:25AM +0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 10:06:25AM +0400, Andrey Zakhvatov wrote: > Hello, > > > Synopsis: Update doc: doc/ru/FAQ/preface.sgml > > > > State-Changed-From-To: open->closed > > State-Changed-By: nik > > State-Changed-When: Tue Aug 17 14:19:38 PDT 1999 > > State-Changed-Why: > > Committed, thanks. > > Sorry, but it looks like that patch was not committed :( That's odd. I'm re-committing these now (to doc/ru_RU.KOI8-R/FAQ). N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 7: 0:59 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 80DF6156F8 for ; Mon, 23 Aug 1999 07:00:33 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 112 invoked by uid 1003); 23 Aug 1999 14:01:17 -0000 Date: Mon, 23 Aug 1999 16:01:17 +0200 From: Neil Blakey-Milner To: Nik Clayton Cc: doc@FreeBSD.org Subject: Re: Some proposed changes in expectation of obj'able doc makes Message-ID: <19990823160116.A96603@rucus.ru.ac.za> References: <19990823115900.A6290@rucus.ru.ac.za> <19990823140332.C2121@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <19990823140332.C2121@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 02:03:32PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon 1999-08-23 (14:03), Nik Clayton wrote: > I'm sure this is a good idea. At least, it looks like a good idea, and > it looks similar to the mechanism used in the src/ Makefiles, and I assume > it's a good idea there as well. > > But what does it actually do? Would you (or anyone else on the list) be > able to write up a description of what the benefits are, and how they > work? This can then be added to the FDP primer, so that newcomers to > the project have something they can read through which explains things > like this? I'll sgml-ify it later, but here's a synopsis: When you're using "make" to create a project, it is possible to have the actual output created by the make process to go into a separate parallel directory tree, so that you don't mess up or otherwise touch the original tree. The advantage in this is that the tree can be mounted read-only, or be owned by another user, exported RO over NFS, be on a CD, or something like that, and still use it to generate the expected bits. It also makes it much harder to by mistake delete the originals by mistake by overwriting them or deleting it whilst aiming at the generated material. It also makes it easier to figure what all you are generating, and whether you're deleting all of it, since anything left behind in the obj directory after a make clean would have ended up in your original directory otherwise. It does this by changing your working directory to .OBJDIR, if it exists, and which is worked out by adding the current directory to MAKEOBJDIRPREFIX, which defaults to /usr/obj. Thus, /usr/doc's .OBJDIR is /usr/obj/usr/doc by default. .CURDIR is the current directory. Make makes sure that the .ALLSRC and .TARGET are converted as necessarily. Using the following example: book.html: book.sgml .TARGET is book.html, and .ALLSRC is book.sgml usually, but in an obj build, .TARGET becomes ${.OBJDIR}/book.html and .ALLSRC becomes ${.CURDIR}/book.sgml. For /usr/doc/foo, .TARGET is /usr/obj/usr/doc/foo/book.html and .ALLSRC is /usr/doc/foo/book.sgml. The problem in generating obj'able build processes is remember what directory you are in, and how to get to files, because you're changed into the .OBJDIR directory. In my example, DOC_PREFIX=../../.. doesn't help, since you can't use it to find the actual doc prefix from .OBJDIR, since its ../../.. usually points somewhere other than you expect. This is especially so if you're doing "jade -d ${DOC_PREFIX}" or whatever, since it's working directory is actually .OBJDIR, and you don't want a relative path. Hope that helps, Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 8:10: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 97485157A1 for ; Mon, 23 Aug 1999 08:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA70957; Mon, 23 Aug 1999 08:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from troutmask.apl.washington.edu (troutmask.apl.washington.edu [128.95.76.54]) by hub.freebsd.org (Postfix) with ESMTP id 666C3156E9 for ; Mon, 23 Aug 1999 08:09:36 -0700 (PDT) (envelope-from kargl@troutmask.apl.washington.edu) Received: (from root@localhost) by troutmask.apl.washington.edu (8.9.3/8.9.1) id IAA16584; Mon, 23 Aug 1999 08:13:13 -0700 (PDT) (envelope-from kargl) Message-Id: <199908231513.IAA16584@troutmask.apl.washington.edu> Date: Mon, 23 Aug 1999 08:13:13 -0700 (PDT) From: "Steven G. Kargl" Reply-To: kargl@troutmask.apl.washington.edu To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13333: remove rtld(1) XREF in dlopen.3 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13333 >Category: docs >Synopsis: remove rtld(1) XREF in dlopen.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: Mon Aug 23 08:10:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Steven G. Kargl >Release: FreeBSD 4.0-CURRENT i386 >Organization: APL/UW >Environment: FreeBSD-current >Description: dlopen(3) contains a cross reference to rtld(1). rtld(1) appears to be absence on FreeBSD-current. >How-To-Repeat: >Fix: --- dlopen.3.orig Mon Aug 23 08:08:28 1999 +++ dlopen.3 Mon Aug 23 08:08:46 1999 @@ -241,6 +241,4 @@ .Fn dlerror . .Sh SEE ALSO .Xr ld 1 , -.Xr rtld 1 , .Xr link 5 - >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 10:22:58 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mail.kt.rim.or.jp (mail.kt.rim.or.jp [202.247.130.53]) by hub.freebsd.org (Postfix) with ESMTP id 7F1E014FBA for ; Mon, 23 Aug 1999 10:22:49 -0700 (PDT) (envelope-from kuriyama@sky.rim.or.jp) Received: from rhea.sky.rim.or.jp (ppp539.kt.rim.or.jp [202.247.140.189]) by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id CAA07658 for ; Tue, 24 Aug 1999 02:22:04 +0900 (JST) Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1]) by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id CAA49498 for ; Tue, 24 Aug 1999 02:22:02 +0900 (JST) Date: Tue, 24 Aug 1999 02:21:59 +0900 Message-ID: <14273.33591.825261.22222V@localhost.sky.rim.or.jp> From: Jun Kuriyama To: doc@freebsd.org Subject: Re: Default FDP docs installation directory? In-Reply-To: In your message of "Sun, 22 Aug 1999 22:14:07 +0100" <19990822221406.A80051@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990822221406.A80051@catkin.nothing-going-on.org> User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Sorry for my absence. The biggest problem is my poor English skills not to be able to write and read long discussion like this. And because of my job, I cannot spend much time for FreeBSD in weekdays. As you know, currently under pre-freeze time for 3.3-RELEASE, and I have many patches to be reviewed and committed before freeze. From: Nik Clayton > 1. LinuxDoc is dying. SGMLTools, the main 'wrapper' around it in the > Linux world has switched to DocBook, and the Linux Documentation > Project is moving towards it (although not as quickly as we have -- > this is mostly because we have less documentation to convert). > 2. DocBook is a far better designed DTD. Yes, there's more to learn > about it (which is why I wrote, and continue to write, the primer), > but it's more extensible, more flexible and more widely supported. > 3. DocBook as a DTD promotes consistency in the choice of markup. This > is a good thing, as it (a) makes the job of marking things up easier, > (b) allows more consistency in the output, giving a strong sense of > 'family' between the documents, (c) prevents the author having to worry > about what their document will look like, and instead concentrate on > marking up their documentation accurately. These things are technically true. But when many committers and doc-submitters don't use emacs, more verbose self-described markup language (like DocBook) makes difficult to write for them. Should we (emacs users) consider them? > 4. DocBook is a "richer" markup model, so our documents will be easier > to downgrade to other markup models (like, for example, HTML, or > PilotDoc). As Satoshi said, HTML rendering for our handbook is not completed yet. We should refine that before going to another work like repository reorganization. > > Also, the Japanese PS and PDF handbook generation is still broken > > since the Linuxdoc -> Docbook switchover. > It is? Define broken? I know that there were problems, but I was under > the impression that Jun Kuriyama had fixed them, updated the port, and > forwarded them on to Norm Walsh. Yes, currently that is broken. teTeX cannot handle Japanese encoding and jadetex also needs patches for Japanese TeX suite. And I don't have Japanese handling specification in PDF. I think dvi2ps and ps2pdf converter help us, but that seems more far stage... > OK, seriously, for a moment: if you felt the need to write that then > something has gone seriously wrong. I'd like to hear from the members > of the Japanese Doc. Proj. (in private mail please, not withstanding the > disclaimer at the start of this message, I don't think we need to subject > -doc to the rest of this) so we can discuss this a little more slowly and > a little more calmly. I mean no offense to you Satoshi, but until this > little blow-up my contact with the Japanese translators was Jun Kuriyama, > and he's been conspicuously absent from this thread. So, everything in these thread (including ones in long ago) is too speedy for me. And many things are decided before I can make spare time for that discussion. I want to walk more slowly in discussion and in Doc Project working. I think many translation team have technical problem, but most of that is local problem which should be solved in local mailing-list. Of course, not saying like: > Sorry, can we postpone this change please. We haven't got the manpower > to dedicate to it right now. is our fault. (but really I haven't saying that? :-) But I don't have any idea for some technical problems, so I cannot say "please postpone until ." Can we say "please postpone" in these situation? Hmmm. I took over 1 hour to write this mail and much sleepy. Can I postpone to replying other comments? :-) > PS: Oh, one more thing. I'm going to be over for FreeBSD Con. in > October, and I understand that some of the Japanese translation > team are going to be there as well -- could we maybe postpone this > whole thing until we can sit down and talk about it face to face? > I'm a lovely guy in person, willing to stand my own round of drinks, > and I can probably bore you all with pictures of my girlfriend. I'll go to FreeBSDCon, too. And Satoshi said he will there. I don't know other person's plan... > PPPS: OK, seriously for a moment again. "Jun Kuriyama". Am I right in > using "Jun" in the same way other people would refer to me as "Nik", > or have I got it backwards? I've asked about this before, but I > think it got lost in the noise, and the last time the topic came up > (on another mailing list as it happens) I don't recall any clear > consensus -- thanks. "Jun" is my first name, and "Kuriyama" is family name. So calling me "Jun" is correct usage. Jun Kuriyama // kuriyama@FreeBSD.org // kuriyama@FreeBSD.ORG To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 11: 1: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id D984615388 for ; Mon, 23 Aug 1999 11:00:52 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA85516 for freebsd-doc@freebsd.org; Mon, 23 Aug 1999 11:00:52 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 23 Aug 1999 11:00:52 -0700 (PDT) Message-Id: <199908231800.LAA85516@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Subject: Current unassigned doc problem reports Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Current FreeBSD problem reports 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. Bugs can be in one of several states: o - open A problem report has been submitted, no sanity checking performed. a - analyzed The report has been examined by a team member and evaluated. f - feedback The problem has been solved, and the originator has been given a patch or a fix has been committed. The PR remains in this state pending a response from the originator. s - suspended The problem is not being worked on. This is a prime candidate for somebody who is looking for a project to do. If the problem cannot be solved at all, it will be closed, rather than suspended. c - closed A problem report is closed when any changes have been integrated, documented, and tested. Critical problems Serious problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- f [1999/08/05] docs/12988 doc [Patch] Fix more occurances of 'sd' in FA o [1999/08/11] docs/13088 doc Handbook lists support for Adaptec 2930, 2 problems total. Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- a [1998/07/31] docs/7456 doc dialog(3) man page outdated a [1998/08/31] docs/7791 doc ipf(1) and ipfstat(1) should have been ip o [1998/09/13] docs/7914 doc no elf(5) manpage o [1998/10/25] docs/8445 doc Update of "Installing Mathematica on Free o [1999/02/14] docs/10085 doc NIS Setup Tutorial o [1999/02/14] docs/10098 doc Lack of overall guide for NIS setup o [1999/02/21] docs/10182 doc http://www.freebsd.org/cgi/query-pr.cgi?p o [1999/02/25] docs/10240 doc We need a script which check if our web m o [1999/03/18] docs/10664 doc Notes on 2.2.8 -> 3.1 migration o [1999/03/29] docs/10850 doc submitting a documentation change for sed o [1999/04/07] docs/10997 doc Problem with query-pr-summary.cgi o [1999/04/21] docs/11258 doc suggestion to refine npx.4 o [1999/06/01] docs/11978 doc timed(8) manpage does not define '-F' swi o [1999/07/15] docs/12657 doc Handbook on ftp mirrors is old... o [1999/07/17] docs/12684 doc Correction to your website for ZNYX Corp. o [1999/07/22] bin/12767 doc Expand /etc/ttys manpage o [1999/08/03] docs/12940 doc make world translated to French o [1999/08/04] docs/12951 doc missing link to japanese mailing list gui o [1999/08/04] docs/12969 doc Informacion incorrecta para versiones Fre o [1999/08/05] docs/12985 doc small change to ccdconfig man page o [1999/08/08] docs/13034 doc incorrect (old/obsolete) manpage for name o [1999/08/08] docs/13037 doc netstat(1) -a flag with -r is undocumente o [1999/08/11] docs/13079 doc new man page describing timeradd() family o [1999/08/12] docs/13096 doc Update doc: doc/ru/FAQ/applications.sgml o [1999/08/13] docs/13116 doc typo in ms(7) o [1999/08/14] docs/13134 doc A typo in ax.4 manual pages o [1999/08/15] docs/13153 doc fdc.4 has typo (a line which begin with ' o [1999/08/17] docs/13194 doc Bad info in handbook/kernelconfig o [1999/08/17] docs/13207 doc Update to the FAQ o [1999/08/17] docs/13208 doc Correct typo in FAQ o [1999/08/17] docs/13210 doc device_add_chils_after.9 is obsolete o [1999/08/18] docs/13222 doc Missing links for {v,}{err,warn}c functio o [1999/08/18] docs/13225 doc fpa.4 seems to be i386 specific and shoul o [1999/08/18] docs/13226 doc alpm.4 has not linked to .../man/man4 o [1999/08/18] docs/13227 doc [PATCH] some staff in .../man/man4/i386 n o [1999/08/18] docs/13229 doc hier.7 is out-of-date o [1999/08/19] docs/13256 doc [PATCH] security.7 style and copyright se o [1999/08/20] docs/13283 doc A macro used in 'asc.4' should be changed o [1999/08/21] docs/13284 doc Allow .Rv macro for man section 7 o [1999/08/21] docs/13289 doc sc is documented, but manpage not present o [1999/08/23] docs/13330 doc Release notes for 3.0 release are incorre o [1999/08/23] docs/13331 doc www/docproj/translations.sgml has errors o [1999/08/23] docs/13333 doc remove rtld(1) XREF in dlopen.3 43 problems total. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 11:51:17 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sand2.global.net.uk (sand2.global.net.uk [195.147.246.100]) by hub.freebsd.org (Postfix) with ESMTP id 4428D14F55; Mon, 23 Aug 1999 11:50:44 -0700 (PDT) (envelope-from mark@globalnet.co.uk) Received: from p00s11a06.client.global.net.uk ([195.147.219.1] helo=marder-1.) by sand2.global.net.uk with esmtp (Exim 2.05 #1) id 11Iz9r-0004TY-00; Mon, 23 Aug 1999 19:49:28 +0100 Received: (from mark@localhost) by marder-1. (8.9.2/8.8.8) id TAA00374; Mon, 23 Aug 1999 19:42:19 +0100 (BST) (envelope-from mark) Date: Mon, 23 Aug 1999 19:42:18 +0100 From: Mark Ovens To: Nik Clayton Cc: doc@freebsd.org Subject: Re: How to build DocBook docs? Message-ID: <19990823194218.B267@marder-1> References: <19990822235910.F271@marder-1> <19990823134838.A2121@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.3i In-Reply-To: <19990823134838.A2121@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 01:48:38PM +0100 Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 01:48:38PM +0100, Nik Clayton wrote: > On Sun, Aug 22, 1999 at 11:59:11PM +0100, Mark Ovens wrote: > > Are there any instructions anywhere on building the new (DocBook) > > docs? I can build the LinuxDoc ones OK, but the DocBook ones just > > generates lots of errors from jade, like: > > > > cannot open "/usr/local/share/sgml/docbook/dsssl/modular/catalog" (No such file or directory) > > Take a look in /var/db/pkg, and pkg_delete(1) anything you have installed > with "docbook" in the package name (docbook-*, and dsssl-docbook-* probably). > > Then > > # cd /usr/ports/textproc > # cd docbook > # make install > # cd ../dsssl-docbook-modular > # make install > > That should fix it. > Thanks Nik :-) > N > -- > [intentional self-reference] can be easily accommodated using a blessed, > non-self-referential dummy head-node whose own object destructor severs > the links. > -- Tom Christiansen in <375143b5@cs.colorado.edu> > -- STATE-OF-THE-ART: Any computer you can't afford. OBSOLETE: Any computer you own. ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 13:12:46 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id A515014EF7 for ; Mon, 23 Aug 1999 13:12:43 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id NAA95494; Mon, 23 Aug 1999 13:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from bamf.demon.co.uk (bamf.demon.co.uk [158.152.173.140]) by hub.freebsd.org (Postfix) with SMTP id 8E3C51504B for ; Mon, 23 Aug 1999 13:07:55 -0700 (PDT) (envelope-from rich@chugaboom.net) Received: from zippy.chugaboom.net (unverified [192.168.1.1]) by clyde.chugaboom.net (EMWAC SMTPRS 0.83) with SMTP id ; Mon, 23 Aug 1999 20:57:27 +0100 Received: by zippy.chugaboom.net (Postfix, from userid 1001) id 78399132; Mon, 23 Aug 1999 20:52:03 +0100 (BST) Message-Id: <19990823195203.78399132@zippy.chugaboom.net> Date: Mon, 23 Aug 1999 20:52:03 +0100 (BST) From: rich@FreeBSD.org.uk Reply-To: rich@FreeBSD.org.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13336: FAQ corrections Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13336 >Category: docs >Synopsis: Corrections to URL's in FAQ >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 Aug 23 13:10:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Rich Wood >Release: FreeBSD-Current >Organization: >Environment: >Description: A few corrections to URLs in the new DOCBOOK FAQ. Mainly terminating '/' characters. >How-To-Repeat: N/A >Fix: This is a patch against the UK English version of the FAQ. --- book.sgml.orig Wed Aug 18 21:20:00 1999 +++ book.sgml Mon Aug 23 20:36:48 1999 @@ -48,3 +48,3 @@ code remains. A fuller description of what FreeBSD is and how -it can work for you may be found on the FreeBSD home page. +it can work for you may be found on the FreeBSD home page. @@ -125,3 +125,3 @@ -Version 3.2 is the latest stable version; it was released +Version 3.2 is the latest stable version; it was released in May, 1999. This is also the latest release version. @@ -2471,3 +2471,3 @@ a beta-version of a new X-server that works better, by looking at -the XFree86 site +the XFree86 site and following the links to the new beta release. Get the @@ -2843,4 +2843,4 @@ -Yes, Xi Graphics and -Metro Link sells +Yes, Xi Graphics and +Metro Link sells Accelerated-X product for FreeBSD and other Intel based systems. @@ -3128,3 +3128,3 @@ -Yes. Please see http://www.FreeBSD.org/java. +Yes. Please see http://www.FreeBSD.org/java/. @@ -3137,3 +3137,3 @@ -current or -stable, you may need a ports upgrade kit from -http://www.FreeBSD.org/ports. If you are up to date, then +http://www.FreeBSD.org/ports/. If you are up to date, then someone might have committed a change to the port which works for @@ -5476,3 +5476,3 @@ ALTQ is available for free; Bandwidth Manager from -Emerging Technologies is +Emerging Technologies is a commercial product. @@ -5556,3 +5556,3 @@ command, you should download the -latest version. +latest version. It will build on FreeBSD version 2.1.5 and higher. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 14: 6:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 84857151EB; Mon, 23 Aug 1999 14:06:10 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA66174; Mon, 23 Aug 1999 21:51:45 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 21:51:44 +0100 From: Nik Clayton To: Jun Kuriyama Cc: doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990823215144.A63576@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990822221406.A80051@catkin.nothing-going-on.org> <14273.33591.825261.22222V@localhost.sky.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <14273.33591.825261.22222V@localhost.sky.rim.or.jp>; from Jun Kuriyama on Tue, Aug 24, 1999 at 02:21:59AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Jun, Me again: On Tue, Aug 24, 1999 at 02:21:59AM +0900, Jun Kuriyama wrote: > Yes, currently that is broken. teTeX cannot handle Japanese encoding > and jadetex also needs patches for Japanese TeX suite. > > And I don't have Japanese handling specification in PDF. I think > dvi2ps and ps2pdf converter help us, but that seems more far stage... I've just had a look at the top of the Japanese Handbook. Isn't it supposed to start ? I know you've got the "lang.ja" parameter in freebsd.dsl, but I just tried to build the Japanese handbook, and on the "jade" command line that's echoed I don't see "-ilang.ja" in the command line. If I edit ..../books/Makefile, and s/JADEOPTS/JADEFLAGS/ then it seems to do the right thing, and "-ilang.ja" is passed to jade. However, in freebsd.dsl you have the following; ... (define %html-header-tags% '(("META" ...)))) ]]> Right? That looks wrong to me. If you pass "-ilang.ja" to jade then that will be converted to ... (define %html-header-tags% '(("META" ...)))) ]]> so the "(define %gentext-language% "ja")" is never encountered. I've just tried # cd .../ja_JP.eucJP/books/handbook # make "JADEFLAGS=-ilang.ja -ilang.ja.dsssl" book.ps but get lots of "Warning: Unknown character" errors from tex. I assume these are the problems you're encountering, yes? N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 14: 6:42 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 7D0B815791; Mon, 23 Aug 1999 14:06:10 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA63142; Mon, 23 Aug 1999 21:27:47 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 21:27:46 +0100 From: Nik Clayton To: Jun Kuriyama Cc: doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990823212745.A56105@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990822221406.A80051@catkin.nothing-going-on.org> <14273.33591.825261.22222V@localhost.sky.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <14273.33591.825261.22222V@localhost.sky.rim.or.jp>; from Jun Kuriyama on Tue, Aug 24, 1999 at 02:21:59AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 02:21:59AM +0900, Jun Kuriyama wrote: > Sorry for my absence. The biggest problem is my poor English skills Your English is much better than my Japanese > And because of my job, I cannot spend much time for FreeBSD in > weekdays. As you know, currently under pre-freeze time for > 3.3-RELEASE, and I have many patches to be reviewed and committed > before freeze. That's very true. I'm more than happy to postpone this discussion until after 3.3 is out. > These things are technically true. But when many committers and > doc-submitters don't use emacs, more verbose self-described markup > language (like DocBook) makes difficult to write for them. Should we > (emacs users) consider them? Indeed we should, and I'm open to suggestions as to what we can do. We already accept plain text (or even HTML) doc submissions, so that other people can do the markup as necessary. I don't use editors other than vi and emacs, but if someone wants to submit text and hints for the FDP primer for users of editors other than Emacs I'm all for it. > > 4. DocBook is a "richer" markup model, so our documents will be easier > > to downgrade to other markup models (like, for example, HTML, or > > PilotDoc). > > As Satoshi said, HTML rendering for our handbook is not completed > yet. Do you mean the Japanese translated Handbook, or the Handbook as a whole? Satoshi bought up the fact that sections weren't numbered, and I posted 3 lines of code that fixed that. Since no one's complained about it, I'll commit a freebsd.dsl that turns on that sort of numbering shortly. But we can't fix these if we don't know about them. Satoshi (or anyone else for that matter) may very well be going around thinking that there's some fundamental problem with the HTML conversion, but unless they post about it here it won't be addressed. > We should refine that before going to another work like > repository reorganization. IMHO, the two issues are separate and unrelated. We can work on one while doing the other. > > > Also, the Japanese PS and PDF handbook generation is still broken > > > since the Linuxdoc -> Docbook switchover. > > > It is? Define broken? I know that there were problems, but I was under > > the impression that Jun Kuriyama had fixed them, updated the port, and > > forwarded them on to Norm Walsh. > > Yes, currently that is broken. teTeX cannot handle Japanese encoding > and jadetex also needs patches for Japanese TeX suite. > > And I don't have Japanese handling specification in PDF. I think > dvi2ps and ps2pdf converter help us, but that seems more far stage... My cursory reading of the teTeX info pages tells me that this should be possible, but I don't know how to accomplish it. Is there someone on the Japanese team who could act as a 'point man' for this problem? I can probably find various people who are competent in TeX, but I couldn't effectively describe the problem for them, and I couldn't effectively test any solutions they suggest. > > OK, seriously, for a moment: if you felt the need to write that then > > something has gone seriously wrong. I'd like to hear from the members > > of the Japanese Doc. Proj. (in private mail please, not withstanding the > > disclaimer at the start of this message, I don't think we need to subject > > -doc to the rest of this) so we can discuss this a little more slowly and > > a little more calmly. I mean no offense to you Satoshi, but until this > > little blow-up my contact with the Japanese translators was Jun Kuriyama, > > and he's been conspicuously absent from this thread. > > So, everything in these thread (including ones in long ago) is too > speedy for me. And many things are decided before I can make spare > time for that discussion. > > I want to walk more slowly in discussion and in Doc Project working. That's fine. I'm being pulled in two different directions here -- on the one side I've got people saying "This is broken/doesn't look nice, fix it now", and on the other side I've got people who need more time. I'm happy to err on the side of caution, and delay things as appropriate. > Hmmm. I took over 1 hour to write this mail and much sleepy. Can I > postpone to replying other comments? :-) Absolutely. It took me 3 hours to write 4 messages last night, and I've spent most of today in bed with a headache the size of Texas. About the only thing I would like to get some resolution on is the issue with Japanese teTeX. This is obviously quite a problem, and if someone with from the Japanese team would like to volunteer to liase with me on fixing it, lets see what we can work out. Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 14:18: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp11.bellglobal.com (smtp11.bellglobal.com [204.101.251.53]) by hub.freebsd.org (Postfix) with ESMTP id 758CB14D6B; Mon, 23 Aug 1999 14:17:58 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18344.on.bellglobal.com (ppp18416.on.bellglobal.com [206.172.130.96]) by smtp11.bellglobal.com (8.8.5/8.8.5) with ESMTP id RAA28805; Mon, 23 Aug 1999 17:21:19 -0400 (EDT) Received: (from tim@localhost) by ppp18344.on.bellglobal.com (8.9.3/8.9.1) id RAA42498; Mon, 23 Aug 1999 17:20:06 -0400 (EDT) (envelope-from tim) Date: Mon, 23 Aug 1999 17:20:05 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990823172005.C42397@ppp18344.on.bellglobal.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990823141611.A1770@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 09:16:11AM -0400 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 09:16:11AM -0400, Nik Clayton wrote: > > Can you put this forward to -doc, and see what other English contributors, > and the translation teams, have to say about it. Ok. Hello? Fellow -doc readers? Please read the following quoted paragraph. (Thanks). Comments welcome. >> Would you [encourage|discourage] me from writing new hunks of >> documentation that use DocBook with a formatting style such that each >> new sentence begins on a new line? The idea here is that this would >> make future diffs clearer and easier to read. This would directly >> make synchronization of translations easier. Nik snipped the part where I wrote: >> Of course, I don't plan to gratuitously change any existing docs, and >> I generally wouldn't do this unless the new hunk is of significant >> size (say at least a paragraph). The original context indicating that this is really just something I want to do for my own writing, and not any type of new policy that I'm suggesting, was also lost. I hereby re-establish the context. [As per standard procedure, a dearth of comments will be interpreted as approval... :-] [Nik's comment] > I can see how it makes the translations easier. I can also see how it > makes editing the content after it's been written more complicated (no more > M-q to refill the paragraph -- aargh). Tim doesn't use emacs. Tim tried emacs, simply because Tim felt that if Nik wanted people to use emacs to edit the handbook, Tim should try emacs. Tim gagged and threw-up. Tim doesn't see a problem, here. :) -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 14:34: 7 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id C73A714E5E; Mon, 23 Aug 1999 14:34:00 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id WAA71661; Mon, 23 Aug 1999 22:33:35 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 22:33:35 +0100 From: Nik Clayton To: Tim Vanderhoek Cc: Nik Clayton , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990823223335.A71020@catkin.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990823172005.C42397@ppp18344.on.bellglobal.com>; from Tim Vanderhoek on Mon, Aug 23, 1999 at 05:20:05PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 05:20:05PM -0400, Tim Vanderhoek wrote: > [As per standard procedure, a dearth of comments will be interpreted > as approval... :-] Given recent events, I'd feel happier if at least one or two of the translation teams actually stepped forward and said "Yes, good idea" before we agreed to this. I don't see a real problem with doing it, but it is quite a big change, and it'd be nice to know that people other than yourself will actually be finding it useful. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 14:49:17 1999 Delivered-To: freebsd-doc@freebsd.org Received: from logatome.micronet.fr (logatome-2.francenet.fr [193.149.96.2]) by hub.freebsd.org (Postfix) with ESMTP id 8FC5C14D25; Mon, 23 Aug 1999 14:49:13 -0700 (PDT) (envelope-from Sebastien.Gioria@FranceNet.fr) Received: from gioria.dialup.FranceNet.fr (eku28.dialup.francenet.fr [193.149.106.173] (may be forged)) by logatome.micronet.fr (8.8.8/8.8.8) with ESMTP id XAA16529; Mon, 23 Aug 1999 23:44:56 +0200 (CEST) Received: by gioria.dialup.FranceNet.fr (Postfix, from userid 42) id 807171FE5F; Mon, 23 Aug 1999 23:46:10 +0200 (CEST) Message-ID: <19990823234610.F53660@FranceNet.fr> Date: Mon, 23 Aug 1999 23:46:10 +0200 From: Sebastien GIORIA To: Nik Clayton , Tim Vanderhoek , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Reply-To: Sebastien GIORIA References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990823223335.A71020@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.93.2i In-Reply-To: <19990823223335.A71020@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 10:33:35PM +0100 Operating-System: Definitely FreeBSD Function: Security Administrator X-Work-Organization: FranceNet X-Work-Postal-Address: 28 Rue Desaix , 75015 Paris, France, Terre X-Home-Organization: French FreeBSD Documentation Project X-Home-Postal-Address: 32 Rue Baron Le Roy, 75012 Paris, France, Terre X-Operating-System: FreeBSD-STABLE + PAO enabled X-URL-Home: http://www.FreeBSD-fr.org X-URL-Work: http://www.FranceNet.fr Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 10:33:35PM +0100, the keyboard of Nik Clayton write: nik > Given recent events, I'd feel happier if at least one or two of the nik > translation teams actually stepped forward and said "Yes, good idea" nik > before we agreed to this. I agreed with this idea because I see the problem to stay -CURRENT on the -doc translations :-) S. -- FranceNet Security Administrator Sebastien.Gioria@FranceNet.fr French FreeBSD Documentation Project gioria@FreeBSD.org Tout FreeBSD en Francais http://www.FreeBSD-fr.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:25:36 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 2066814F50; Mon, 23 Aug 1999 19:25:33 -0700 (PDT) (envelope-from jim@FreeBSD.org) Received: (from jim@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA28972; Mon, 23 Aug 1999 19:25:25 -0700 (PDT) (envelope-from jim@FreeBSD.org) Date: Mon, 23 Aug 1999 19:25:25 -0700 (PDT) From: Message-Id: <199908240225.TAA28972@freefall.freebsd.org> To: nbm@rucus.ru.ac.za, jim@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13331: www/docproj/translations.sgml has errors Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: www/docproj/translations.sgml has errors State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Mon Aug 23 19:24:51 PDT 1999 State-Changed-Why: Fixed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:39:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id A9E1A1589A; Mon, 23 Aug 1999 19:39:33 -0700 (PDT) (envelope-from jim@FreeBSD.org) Received: (from jim@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA30568; Mon, 23 Aug 1999 19:37:08 -0700 (PDT) (envelope-from jim@FreeBSD.org) Date: Mon, 23 Aug 1999 19:37:08 -0700 (PDT) From: Message-Id: <199908240237.TAA30568@freefall.freebsd.org> To: sobomax@altavista.net, jim@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13330: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Release notes for 3.0 release are incorrectly mentioning dosemu instead of doscmd State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Mon Aug 23 19:36:36 PDT 1999 State-Changed-Why: Fixed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:39:41 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 4827115829; Mon, 23 Aug 1999 19:39:33 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Received: (from cpiazza@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA30501; Mon, 23 Aug 1999 19:37:00 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Date: Mon, 23 Aug 1999 19:37:00 -0700 (PDT) From: Message-Id: <199908240237.TAA30501@freefall.freebsd.org> To: marko@globalnet.co.uk, cpiazza@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13208: Correct typo in FAQ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Correct typo in FAQ State-Changed-From-To: open->closed State-Changed-By: cpiazza State-Changed-When: Mon Aug 23 19:36:49 PDT 1999 State-Changed-Why: Patch committed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:45:36 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 865B714CE9; Mon, 23 Aug 1999 19:45:35 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Received: (from cpiazza@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA31050; Mon, 23 Aug 1999 19:43:02 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Date: Mon, 23 Aug 1999 19:43:02 -0700 (PDT) From: Message-Id: <199908240243.TAA31050@freefall.freebsd.org> To: kiril@ideaglobal.com, cpiazza@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/12985: small change to ccdconfig man page Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: small change to ccdconfig man page State-Changed-From-To: open->closed State-Changed-By: cpiazza State-Changed-When: Mon Aug 23 19:42:06 PDT 1999 State-Changed-Why: Changed by jkoshy in rev 1.7 and 1.6.2.1 in RELENG_3, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:53:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp11.bellglobal.com (smtp11.bellglobal.com [204.101.251.53]) by hub.freebsd.org (Postfix) with ESMTP id A482C14DC0; Mon, 23 Aug 1999 19:53:49 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18344.on.bellglobal.com (ppp6631.on.bellglobal.com [206.172.208.223]) by smtp11.bellglobal.com (8.8.5/8.8.5) with ESMTP id WAA09662; Mon, 23 Aug 1999 22:56:03 -0400 (EDT) Received: (from tim@localhost) by ppp18344.on.bellglobal.com (8.9.3/8.9.1) id WAA01637; Mon, 23 Aug 1999 22:54:49 -0400 (EDT) (envelope-from tim) Date: Mon, 23 Aug 1999 22:54:48 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990823225448.A1517@ppp18344.on.bellglobal.com> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990822221406.A80051@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990822221406.A80051@catkin.nothing-going-on.org>; from Nik Clayton on Sun, Aug 22, 1999 at 10:14:07PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Aug 22, 1999 at 10:14:07PM +0100, Nik Clayton wrote: > > > If I don't get an answer this time, I will assume you lied the first > > time around and in fact didn't talk to anybody on the Japanese team. [...] > Tell you what, since this is the new happy, shiny, FDP organisation, where > consensus rules, I'll throw this one out to the assembled masses. Hey > guys, if you're reading this, and you've got a strong opinion as to which For once I don't know what to say... Generally your mails are a model of style. I think you're trying too hard. I think you need to find a more physical sport than badminton. ;-) -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:55: 9 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id B9E7614DC0; Mon, 23 Aug 1999 19:55:08 -0700 (PDT) (envelope-from jim@FreeBSD.org) Received: (from jim@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA32303; Mon, 23 Aug 1999 19:55:08 -0700 (PDT) (envelope-from jim@FreeBSD.org) Date: Mon, 23 Aug 1999 19:55:08 -0700 (PDT) From: Message-Id: <199908240255.TAA32303@freefall.freebsd.org> To: wosch@panke.de.freebsd.org, jim@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/10182: http://www.freebsd.org/cgi/query-pr.cgi?pr=5038 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: http://www.freebsd.org/cgi/query-pr.cgi?pr=5038 State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Mon Aug 23 19:53:30 PDT 1999 State-Changed-Why: Explained by jkoshy in a follow-up and no reply to my follow-up so I'm closing it. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 19:55:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id C967914DC0; Mon, 23 Aug 1999 19:55:23 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18344.on.bellglobal.com (ppp6631.on.bellglobal.com [206.172.208.223]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id WAA11320; Mon, 23 Aug 1999 22:57:12 -0400 (EDT) Received: (from tim@localhost) by ppp18344.on.bellglobal.com (8.9.3/8.9.1) id WAA01656; Mon, 23 Aug 1999 22:57:41 -0400 (EDT) (envelope-from tim) Date: Mon, 23 Aug 1999 22:57:40 -0400 From: Tim Vanderhoek To: Jun Kuriyama Cc: doc@FreeBSD.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990823225740.B1517@ppp18344.on.bellglobal.com> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990822221406.A80051@catkin.nothing-going-on.org> <14273.33591.825261.22222V@localhost.sky.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <14273.33591.825261.22222V@localhost.sky.rim.or.jp>; from Jun Kuriyama on Tue, Aug 24, 1999 at 02:21:59AM +0900 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 02:21:59AM +0900, Jun Kuriyama wrote: > > These things are technically true. But when many committers and > doc-submitters don't use emacs, more verbose self-described markup > language (like DocBook) makes difficult to write for them. Should we > (emacs users) consider them? I hate emacs. I love DocBook. Any writer who spends more time typing markup than thinking about the correct content deserves to be shot. -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 20: 0:52 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 37E7C14F97; Mon, 23 Aug 1999 20:00:50 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Received: (from cpiazza@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id UAA33365; Mon, 23 Aug 1999 20:00:50 -0700 (PDT) (envelope-from cpiazza@FreeBSD.org) Date: Mon, 23 Aug 1999 20:00:50 -0700 (PDT) From: Message-Id: <199908240300.UAA33365@freefall.freebsd.org> To: wosch@panke.de.freebsd.org, cpiazza@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/12684: Correction to your website for ZNYX Corp. Hardware Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Correction to your website for ZNYX Corp. Hardware State-Changed-From-To: open->closed State-Changed-By: cpiazza State-Changed-When: Mon Aug 23 20:00:13 PDT 1999 State-Changed-Why: This was fixed by nik but he forgot to close the PR, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 20:13:49 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id D50B114FE0; Mon, 23 Aug 1999 20:13:48 -0700 (PDT) (envelope-from jim@FreeBSD.org) Received: (from jim@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id UAA34661; Mon, 23 Aug 1999 20:13:17 -0700 (PDT) (envelope-from jim@FreeBSD.org) Date: Mon, 23 Aug 1999 20:13:17 -0700 (PDT) From: Message-Id: <199908240313.UAA34661@freefall.freebsd.org> To: eagle@freebsd-fr.org, jim@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/12940: make world translated to French Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: make world translated to French State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Mon Aug 23 20:12:44 PDT 1999 State-Changed-Why: Added, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 20:29:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 69DCF153A6; Mon, 23 Aug 1999 20:29:36 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Received: (from jhb@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id UAA36218; Mon, 23 Aug 1999 20:28:12 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Date: Mon, 23 Aug 1999 20:28:12 -0700 (PDT) From: Message-Id: <199908240328.UAA36218@freefall.freebsd.org> To: jobaldwi@vt.edu, jhb@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/12657: Handbook on ftp mirrors is old... Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Handbook on ftp mirrors is old... State-Changed-From-To: open->closed State-Changed-By: jhb State-Changed-When: Mon Aug 23 20:27:19 PDT 1999 State-Changed-Why: The new doc/ makefiles render this PR obsolete. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 21:52: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 8E89D14F2B for ; Mon, 23 Aug 1999 21:52:06 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id VAA43984; Mon, 23 Aug 1999 21:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from cc942873-a.ewndsr1.nj.home.com (cc942873-a.ewndsr1.nj.home.com [24.2.89.207]) by hub.freebsd.org (Postfix) with ESMTP id E715414CE1 for ; Mon, 23 Aug 1999 21:46:35 -0700 (PDT) (envelope-from cjc@cc942873-a.ewndsr1.nj.home.com) Received: (from cjc@localhost) by cc942873-a.ewndsr1.nj.home.com (8.8.8/8.8.8) id AAA01297; Tue, 24 Aug 1999 00:46:24 -0400 (EDT) (envelope-from cjc) Message-Id: <199908240446.AAA01297@cc942873-a.ewndsr1.nj.home.com> Date: Tue, 24 Aug 1999 00:46:24 -0400 (EDT) From: "Crist J. Clark" Reply-To: cjc@cc942873-a.ewndsr1.nj.home.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13340: Opaque and incorrect grammar in sh(1) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13340 >Category: docs >Synopsis: Opaque and incorrect grammar in sh(1) >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 Aug 23 21:50:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Crist J. Clark >Release: FreeBSD 2.2.8-STABLE i386 >Organization: >Environment: 2.2.8-STABLE. Verified it still exists in 3.2-STABLE >Description: In the sh(1) manpage, in the portion about 'Functions,' we have the following crime against the English language, "Making ``-'' local any shell options that are changed via the set command inside the function to be restored to their original values when the function re- turns." This sentence has no verb, and I do not understand what it is trying to say. >How-To-Repeat: man sh >Fix: Since I went to the manpage to read about shell functions and I can't understand it... I can't write a correction. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 22:52:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 5861414E23; Mon, 23 Aug 1999 22:52:21 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Received: (from jkoshy@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA57994; Mon, 23 Aug 1999 22:49:24 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Date: Mon, 23 Aug 1999 22:49:24 -0700 (PDT) From: Message-Id: <199908240549.WAA57994@freefall.freebsd.org> To: rich@FreeBSD.org.uk, jkoshy@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13336: Corrections to URL's in FAQ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Corrections to URL's in FAQ State-Changed-From-To: open->closed State-Changed-By: jkoshy State-Changed-When: Mon Aug 23 22:48:30 PDT 1999 State-Changed-Why: Patch applied to rev 1.4 of "doc/en_US.ISO_8859-1/books/faq/book.sgml", thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Aug 23 23:29:47 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gilliam.users.flyingcroc.net (gilliam.users.flyingcroc.net [207.246.128.2]) by hub.freebsd.org (Postfix) with ESMTP id 026C615903; Mon, 23 Aug 1999 23:29:08 -0700 (PDT) (envelope-from ross@gilliam.users.flyingcroc.net) Received: (from ross@localhost) by gilliam.users.flyingcroc.net (8.9.3/8.9.3) id XAA04813; Mon, 23 Aug 1999 23:28:23 -0700 (PDT) Date: Wed, 18 Aug 1999 12:45:13 -0700 (PDT) Message-Id: <199908240628.XAA04813@gilliam.users.flyingcroc.net> From: Roelof Osinga To: k4n _ Cc: freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG Subject: Re: FreeBSD webdesign Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org k4n _ wrote: > > I thought maybe you would be interested in a free website redesign(or > something) so I downloaded the HTML for your site, and made a few changes. I > made the background black, redid the FreeBSD logo slightly, and darkened the > logos at the bottom to match the color scheme. If you are interested I can > send you a copy, I think it looks pretty cool. See you later Why do people always assume that dark is cool. The purpose of a website is to convey information. That means good readability, not looks. Whereas beauty lies in the eye of the beholder, readability assuredly does not. Barring the by now ancient amber CRT phosphor colors most research shows that black on white (note the order) is best readable. The FreeBSD site is emminently readable, whereas the old freshmeat site was not. In fact with my previous monitor's settings I couldn't even read that site without upping the brightness (I'm a programmer, for text high contrast is needed contrary to the high brightness for graphics work). Clearly I was not alone in that they changed to a much brighter color scheme. As well as black"er" on white lettering. > (i just realized how dumb this letter sounds, but hey its 8:30 in the > morning what do you expect) It's always 8.30 in the morning someplace. B.t.w. you send it to general lists, maybe it would be better to send it directly to the webmaster. Roelof -- Home is where the (@) http://eboa.com/ is. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 1:51:54 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 61B2215094 for ; Tue, 24 Aug 1999 01:51:43 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id BAA75055; Tue, 24 Aug 1999 01:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 49F40150B7 for ; Tue, 24 Aug 1999 01:40:09 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 80609 invoked by uid 1003); 24 Aug 1999 08:41:01 -0000 Message-Id: <19990824084101.80608.qmail@rucus.ru.ac.za> Date: 24 Aug 1999 08:41:01 -0000 From: nbm@rucus.ru.ac.za Reply-To: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13345: obj-related DOC_PREFIX? changes Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13345 >Category: docs >Synopsis: obj-related DOC_PREFIX? changes >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Aug 24 01:50:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Neil Blakey-Milner >Release: FreeBSD 3.0-STABLE i386 >Organization: Rhodes University Computer Users' Society >Environment: FreeBSD rucus.ru.ac.za 3.0-STABLE FreeBSD 3.0-STABLE #0: Tue Feb 9 22:52:23 GMT 1999 grahams@rucus.ru.ac.za:/usr/src/sys/compile/RUCUS-SMP i386 >Description: These are pretty arbitrary preliminary changes to make obj'able doc builds possible. The real stuff depends on this. It applies to all languages. It doesn't cover the tutorials, as they're governed by web.mk (and that's a whole other story) >How-To-Repeat: Try build docs when the obj dir exists. >Fix: Index: en_US.ISO_8859-1/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/Makefile,v retrieving revision 1.3 diff -u -r1.3 Makefile --- Makefile 1999/08/19 20:35:53 1.3 +++ Makefile 1999/08/23 09:30:36 @@ -19,5 +19,5 @@ .include -DOC_PREFIX?= .. +DOC_PREFIX?= ${.CURDIR}/.. .include "../share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/diskless-x/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/diskless-x/Makefile,v retrieving revision 1.2 diff -u -r1.2 Makefile --- Makefile 1999/08/17 21:35:52 1.2 +++ Makefile 1999/08/23 12:20:07 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/fonts/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/fonts/Makefile,v retrieving revision 1.5 diff -u -r1.5 Makefile --- Makefile 1999/08/16 22:09:06 1.5 +++ Makefile 1999/08/23 12:20:24 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/formatting-media/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/formatting-media/Makefile,v retrieving revision 1.2 diff -u -r1.2 Makefile --- Makefile 1999/08/16 22:09:06 1.2 +++ Makefile 1999/08/23 12:20:40 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/mh/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/mh/Makefile,v retrieving revision 1.5 diff -u -r1.5 Makefile --- Makefile 1999/08/16 22:09:07 1.5 +++ Makefile 1999/08/23 12:17:14 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/multi-os/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/multi-os/Makefile,v retrieving revision 1.5 diff -u -r1.5 Makefile --- Makefile 1999/08/16 22:09:08 1.5 +++ Makefile 1999/08/23 12:18:58 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/new-users/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/new-users/Makefile,v retrieving revision 1.4 diff -u -r1.4 Makefile --- Makefile 1999/08/16 22:09:09 1.4 +++ Makefile 1999/08/23 12:19:26 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/articles/programming-tools/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/programming-tools/Makefile,v retrieving revision 1.5 diff -u -r1.5 Makefile --- Makefile 1999/08/16 22:09:10 1.5 +++ Makefile 1999/08/23 12:19:50 @@ -9,6 +9,6 @@ SRCS= article.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/books/faq/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/faq/Makefile,v retrieving revision 1.1 diff -u -r1.1 Makefile --- Makefile 1999/08/17 21:52:02 1.1 +++ Makefile 1999/08/23 12:22:25 @@ -21,6 +21,6 @@ # SGML content SRCS= book.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/books/fdp-primer/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/fdp-primer/Makefile,v retrieving revision 1.3 diff -u -r1.3 Makefile --- Makefile 1999/07/14 22:31:29 1.3 +++ Makefile 1999/08/23 12:23:50 @@ -36,6 +36,6 @@ # Entities SRCS+= chapters.ent -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: en_US.ISO_8859-1/books/handbook/Makefile =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/Makefile,v retrieving revision 1.22 diff -u -r1.22 Makefile --- Makefile 1999/08/17 21:35:54 1.22 +++ Makefile 1999/08/23 12:24:41 @@ -55,5 +55,5 @@ SRCS+= chapters.ent SRCS+= mailing-lists.ent -DOC_PREFIX?= ../../.. -.include "../../../share/mk/docproj.docbook.mk" +DOC_PREFIX?= ${.CURDIR}/../../.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: es_ES.ISO_8859-1/Makefile =================================================================== RCS file: /home/ncvs/doc/es_ES.ISO_8859-1/Makefile,v retrieving revision 1.4 diff -u -r1.4 Makefile --- Makefile 1999/08/19 20:35:57 1.4 +++ Makefile 1999/08/24 06:39:47 @@ -18,5 +18,5 @@ .include -DOC_PREFIX = .. -.include "../share/mk/docproj.docbook.mk" +DOC_PREFIX = ${.CURDIR}/.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: es_ES.ISO_8859-1/books/faq/Makefile =================================================================== RCS file: /home/ncvs/doc/es_ES.ISO_8859-1/books/faq/Makefile,v retrieving revision 1.1 diff -u -r1.1 Makefile --- Makefile 1999/08/18 13:04:30 1.1 +++ Makefile 1999/08/24 06:40:20 @@ -21,6 +21,6 @@ # SGML content SRCS= book.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: ja_JP.eucJP/Makefile =================================================================== RCS file: /home/ncvs/doc/ja_JP.eucJP/Makefile,v retrieving revision 1.7 diff -u -r1.7 Makefile --- Makefile 1999/08/19 20:35:58 1.7 +++ Makefile 1999/08/24 06:40:59 @@ -20,5 +20,5 @@ .include -DOC_PREFIX = .. -.include "../share/mk/docproj.docbook.mk" +DOC_PREFIX = ${.CURDIR}/.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: ja_JP.eucJP/books/handbook/Makefile =================================================================== RCS file: /home/ncvs/doc/ja_JP.eucJP/books/handbook/Makefile,v retrieving revision 1.35 diff -u -r1.35 Makefile --- Makefile 1999/08/16 22:09:12 1.35 +++ Makefile 1999/08/24 06:42:03 @@ -64,5 +64,5 @@ SRCS+= jcontrib/chapter.sgml SRCS+= jauthors.ent -DOC_PREFIX?= ../../.. -.include "../../../share/mk/docproj.docbook.mk" +DOC_PREFIX?= ${.CURDIR}/../../.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: ru_RU.KOI8-R/Makefile =================================================================== RCS file: /home/ncvs/doc/ru_RU.KOI8-R/Makefile,v retrieving revision 1.3 diff -u -r1.3 Makefile --- Makefile 1999/08/19 20:36:00 1.3 +++ Makefile 1999/08/24 06:42:46 @@ -25,5 +25,5 @@ .include -DOC_PREFIX = .. -.include "../share/mk/docproj.docbook.mk" +DOC_PREFIX = ${.CURDIR}/.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: zh_TW.Big5/Makefile =================================================================== RCS file: /home/ncvs/doc/zh_TW.Big5/Makefile,v retrieving revision 1.3 diff -u -r1.3 Makefile --- Makefile 1999/08/19 20:36:02 1.3 +++ Makefile 1999/08/24 06:44:26 @@ -18,5 +18,5 @@ .include -DOC_PREFIX = .. -.include "../share/mk/docproj.docbook.mk" +DOC_PREFIX = ${.CURDIR}/.. +.include "${DOC_PREFIX}/share/mk/docproj.docbook.mk" Index: zh_TW.Big5/books/faq/Makefile =================================================================== RCS file: /home/ncvs/doc/zh_TW.Big5/books/faq/Makefile,v retrieving revision 1.1 diff -u -r1.1 Makefile --- Makefile 1999/08/19 03:56:59 1.1 +++ Makefile 1999/08/24 06:45:03 @@ -21,6 +21,6 @@ # SGML content SRCS= book.sgml -DOC_PREFIX?= ../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. -.include "../../../share/mk/docproj.docbook.mk" +.include "${.CURDIR}/share/mk/docproj.docbook.mk" >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 2:14: 6 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 239FF1585B for ; Tue, 24 Aug 1999 02:14:02 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Received: (from jkoshy@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA76582; Tue, 24 Aug 1999 02:11:51 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Date: Tue, 24 Aug 1999 02:11:51 -0700 (PDT) From: Message-Id: <199908240911.CAA76582@freefall.freebsd.org> X-Mailer: exmh version 2.0.2 2/24/98 To: freebsd-doc@freebsd.org Cc: Subject: New FAQ entry Mime-Version: 1.0 Content-Type: text/plain Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Comments solicited on the following FAQ entry: ---------------------------------------------------------------- Q: Can ordinary users mount floppies and other removable media? A: Yes, they can, but this feature is not enabled by default in FreeBSD. Here is how to allow non-root users to mount devices: 1. As `root' assign the appropriate permissions to the block device associated with the removable media. For example, for floppies: # chmod 777 /dev/fd0 2. As 'root' set the sysctl variable 'vfs.usermount' to '1'. # sysctl -w vfs.usermount=1 Users can now mount '/dev/fd0' onto any directory that they own: 3. $ mkdir ~/my-mount-point $ mount -t msdos /dev/fd0 ~/my-mount-point Unmounting the device is simple: 4. $ umount ~/my-mount-point ---------------------------------------------------------------- Regards, Koshy To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 2:20:20 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 93296158C3 for ; Tue, 24 Aug 1999 02:20:13 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 94688 invoked by uid 1003); 24 Aug 1999 09:20:12 -0000 Date: Tue, 24 Aug 1999 11:20:12 +0200 From: Neil Blakey-Milner To: jkoshy@FreeBSD.ORG Cc: freebsd-doc@FreeBSD.ORG Subject: Re: New FAQ entry Message-ID: <19990824112012.A94250@rucus.ru.ac.za> References: <199908240911.CAA76582@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <199908240911.CAA76582@freefall.freebsd.org>; from jkoshy@FreeBSD.ORG on Tue, Aug 24, 1999 at 02:11:51AM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue 1999-08-24 (02:11), jkoshy@FreeBSD.ORG wrote: > Comments solicited on the following FAQ entry: > > ---------------------------------------------------------------- > Q: Can ordinary users mount floppies and other removable media? > > A: Yes, they can, but this feature is not enabled by default in FreeBSD. > Here is how to allow non-root users to mount devices: I'd like to suggest we mention mtools too. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 2:20:24 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id C5020158E1 for ; Tue, 24 Aug 1999 02:20:21 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA76989; Tue, 24 Aug 1999 02:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 02:20:01 -0700 (PDT) Message-Id: <199908240920.CAA76989@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Robert Garrett Subject: Re: docs/13194: Bad info in handbook/kernelconfig Reply-To: Robert Garrett Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13194; it has been noted by GNATS. From: Robert Garrett To: freebsd-gnats-submit@freebsd.org, eagle@phc.igs.net, sheldonh@freebsd.org Cc: Subject: Re: docs/13194: Bad info in handbook/kernelconfig Date: Tue, 24 Aug 1999 05:12:11 -0400 I will, later tonight or tommorrow, rewrite that text so it is a little clearer. with all the people coming to freebsd who are from a linux background, and used to just upgrading the kernel, leaving that statement alone. and pointing them to this documentation for reference. will cause us grief. Rob To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 2:26: 2 1999 Delivered-To: freebsd-doc@freebsd.org Received: from ender.ncsa.es (ender.ncsa.es [194.179.50.15]) by hub.freebsd.org (Postfix) with ESMTP id 3F500153CD; Tue, 24 Aug 1999 02:25:57 -0700 (PDT) (envelope-from jesusr@ncsa.es) Received: from ender.ncsa.es (localhost [127.0.0.1]) by ender.ncsa.es (8.9.3/8.9.3) with ESMTP id LAA01693; Tue, 24 Aug 1999 11:23:39 +0200 (CEST) (envelope-from jesusr@ncsa.es) Message-ID: X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <199908240911.CAA76582@freefall.freebsd.org> Date: Tue, 24 Aug 1999 11:23:38 +0200 (CEST) Reply-To: jesusr@ncsa.es Organization: Nexus Comunicaciones, S.A. From: Jesus Rodriguez To: jkoshy@FreeBSD.ORG Subject: RE: New FAQ entry Cc: freebsd-doc@FreeBSD.ORG Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 24-Aug-99 jkoshy@FreeBSD.ORG wrote: > > > Comments solicited on the following FAQ entry: > > ---------------------------------------------------------------- > Q: Can ordinary users mount floppies and other removable media? Good!. Saludos JesusR. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 2:32:16 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id A528814EF7 for ; Tue, 24 Aug 1999 02:32:15 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA77466; Tue, 24 Aug 1999 02:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 02:30:02 -0700 (PDT) Message-Id: <199908240930.CAA77466@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Sheldon Hearn Subject: Re: docs/13194: Bad info in handbook/kernelconfig Reply-To: Sheldon Hearn Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13194; it has been noted by GNATS. From: Sheldon Hearn To: Robert Garrett Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/13194: Bad info in handbook/kernelconfig Date: Tue, 24 Aug 1999 11:25:12 +0200 On Tue, 24 Aug 1999 05:12:11 -0400, Robert Garrett wrote: > I will, later tonight or tommorrow, rewrite that text so it is a little > clearer. Feel free to run it by me. However, I honestly think the text is good the way it is. A config(8) which is mismatched with the sources is a common cause of problems. Still, let's see your suggestion. :-) Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3: 8:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix14.ix.netcom.com (dfw-ix14.ix.netcom.com [206.214.98.14]) by hub.freebsd.org (Postfix) with ESMTP id B0F95150BD; Tue, 24 Aug 1999 03:08:39 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix14.ix.netcom.com (8.8.4/8.8.4) id FAA05109; Tue, 24 Aug 1999 05:05:25 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix14.ix.netcom.com via smap (V1.3) id rma005100; Tue Aug 24 05:05:14 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id DAA11663; Tue, 24 Aug 1999 03:05:10 -0700 (PDT) To: Tim Vanderhoek Cc: Nik Clayton , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 24 Aug 1999 03:05:10 -0700 In-Reply-To: Tim Vanderhoek's message of "Mon, 23 Aug 1999 17:20:05 -0400" Message-ID: Lines: 23 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Tim Vanderhoek * Ok. Hello? Fellow -doc readers? Please read the following quoted * paragraph. (Thanks). Comments welcome. * * >> Would you [encourage|discourage] me from writing new hunks of * >> documentation that use DocBook with a formatting style such that each * >> new sentence begins on a new line? The idea here is that this would * >> make future diffs clearer and easier to read. This would directly * >> make synchronization of translations easier. That sounds helpful. * [Nik's comment] * * > I can see how it makes the translations easier. I can also see how it * > makes editing the content after it's been written more complicated (no more * > M-q to refill the paragraph -- aargh). Refilling the paragraph after minor editing is a real pain for translators. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3:10: 6 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 05D6314EA1 for ; Tue, 24 Aug 1999 03:10:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA79845; Tue, 24 Aug 1999 03:10:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 03:10:02 -0700 (PDT) Message-Id: <199908241010.DAA79845@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Robert Garrett Subject: Re: docs/13194: Bad info in handbook/kernelconfig Reply-To: Robert Garrett Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13194; it has been noted by GNATS. From: Robert Garrett To: freebsd-gnats-submit@freebsd.org, eagle@phc.igs.net, sheldonh@freebsd.org Cc: Subject: Re: docs/13194: Bad info in handbook/kernelconfig Date: Tue, 24 Aug 1999 06:02:56 -0400 Index: chapter.sgml =================================================================== RCS file: /usr/home/ncvs//doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.19 diff -d -r1.19 chapter.sgml 126c126,131 < --- > WARNING: FreeBSD Is not intended to be upgraded in this manner. > if you are intending to upgrade the whole system please use the > make world facilities or do a binary upgrade from sysinstall. Other > wise some system utilites such as ps, top, and possibly others > might not work as expected. > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3:10: 6 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 49C2E150DA for ; Tue, 24 Aug 1999 03:10:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA79851; Tue, 24 Aug 1999 03:10:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 03:10:03 -0700 (PDT) Message-Id: <199908241010.DAA79851@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Sheldon Hearn Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Reply-To: Sheldon Hearn Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13340; it has been noted by GNATS. From: Sheldon Hearn To: freebsd-gnats-submit@freebsd.org Cc: "Crist J. Clark" Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Date: Tue, 24 Aug 1999 12:04:38 +0200 How about this? Ciao, Sheldon. Index: sh.1 =================================================================== RCS file: /home/ncvs/src/bin/sh/sh.1,v retrieving revision 1.28 diff -u -d -r1.28 sh.1 --- sh.1 1999/04/19 18:48:26 1.28 +++ sh.1 1999/08/24 10:04:19 @@ -674,7 +674,7 @@ named x. .Pp The only special parameter than can be made local is -``-''. Making ``-'' local any shell options that are +``-''. Making ``-'' local causes any shell options that are changed via the set command inside the function to be restored to their original values when the function returns. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3:22:53 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 647B914E9E for ; Tue, 24 Aug 1999 03:21:19 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA80239; Tue, 24 Aug 1999 03:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 03:20:02 -0700 (PDT) Message-Id: <199908241020.DAA80239@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Sheldon Hearn Subject: Re: docs/13194: Bad info in handbook/kernelconfig Reply-To: Sheldon Hearn Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13194; it has been noted by GNATS. From: Sheldon Hearn To: Robert Garrett Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/13194: Bad info in handbook/kernelconfig Date: Tue, 24 Aug 1999 12:16:22 +0200 Hi Robert, Your text probably does more harm than good, and you're putting it in the wrong place. I would suggest that text like this would feel more comfortable under the "Why Build a Custom Kernel?" section. I'd just explain that recompiling the kernel does not upgrade FreeBSD, and see the section called "The Cutting Edge: FreeBSD-current and FreeBSD-stable" for more details on how to upgrade. Don't mention upgrading with sysinstall, because you usually run into problems if you try to upgrade to a later release using an installed copy of sysinstall. Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3:30: 9 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 1445214D85 for ; Tue, 24 Aug 1999 03:30:07 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA80830; Tue, 24 Aug 1999 03:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 03:30:01 -0700 (PDT) Message-Id: <199908241030.DAA80830@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Chris Costello Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Reply-To: Chris Costello Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13340; it has been noted by GNATS. From: Chris Costello To: Sheldon Hearn Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Date: Tue, 24 Aug 1999 05:19:51 -0500 On Tue, Aug 24, 1999, Sheldon Hearn wrote: > The only special parameter than can be made local is > -``-''. Making ``-'' local any shell options that are > +``-''. Making ``-'' local causes any shell options that are ^^^^^ ^^^^^ This needs to be .Dq. -- |Chris Costello |Computers... are not designed, as we are, for ambiguity. - Thomas `------------------------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 3:51:36 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 87E8B15033 for ; Tue, 24 Aug 1999 03:51:35 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA81704; Tue, 24 Aug 1999 03:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 03:50:01 -0700 (PDT) Message-Id: <199908241050.DAA81704@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Sheldon Hearn Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Reply-To: Sheldon Hearn Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13340; it has been noted by GNATS. From: Sheldon Hearn To: chris@calldei.com Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Date: Tue, 24 Aug 1999 12:39:42 +0200 On Tue, 24 Aug 1999 05:19:51 EST, Chris Costello wrote: > This needs to be .Dq. That's a different problem. ;-) Seriously, though, the whole manpage is riddled with these. Later, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 4: 2:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id ACDFB14C8C for ; Tue, 24 Aug 1999 04:02:44 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA82072; Tue, 24 Aug 1999 04:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 04:00:02 -0700 (PDT) Message-Id: <199908241100.EAA82072@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Chris Costello Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Reply-To: Chris Costello Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13340; it has been noted by GNATS. From: Chris Costello To: Sheldon Hearn Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Date: Tue, 24 Aug 1999 05:48:03 -0500 On Tue, Aug 24, 1999, Sheldon Hearn wrote: > > > On Tue, 24 Aug 1999 05:19:51 EST, Chris Costello wrote: > > > This needs to be .Dq. > > That's a different problem. ;-) > > Seriously, though, the whole manpage is riddled with these. Yeah, I noticed that. It's kind of disgusting in my own doc/ little way. I should probably go through and fix it after you've worked on and committed your patch. And I believe your wording is much more clear than the original wording. -- |Chris Costello |Be careful when a loop exits to the same place from side and bottom. `-------------------------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 4: 4: 1 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 6A8F215033; Tue, 24 Aug 1999 04:04:00 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Received: (from sheldonh@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA84590; Tue, 24 Aug 1999 04:02:52 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Date: Tue, 24 Aug 1999 04:02:52 -0700 (PDT) From: Message-Id: <199908241102.EAA84590@freefall.freebsd.org> To: sheldonh@FreeBSD.org, freebsd-doc@FreeBSD.org, sheldonh@FreeBSD.org Subject: Re: docs/13340: Opaque and incorrect grammar in sh(1) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Opaque and incorrect grammar in sh(1) Responsible-Changed-From-To: freebsd-doc->sheldonh Responsible-Changed-By: sheldonh Responsible-Changed-When: Tue Aug 24 04:01:59 PDT 1999 Responsible-Changed-Why: I'll take this one and turn it into a multi-bird-killer. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 4:26:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp2.vnet.net (smtp2.vnet.net [166.82.1.32]) by hub.freebsd.org (Postfix) with ESMTP id 6B9F215080; Tue, 24 Aug 1999 04:26:48 -0700 (PDT) (envelope-from rivers@dignus.com) Received: from dignus.com (ponds.vnet.net [166.82.177.48]) by smtp2.vnet.net (8.9.1a/8.9.1) with ESMTP id HAA03336; Tue, 24 Aug 1999 07:23:16 -0400 (EDT) Received: from lakes.dignus.com (lakes.dignus.com [10.0.0.3]) by dignus.com (8.9.2/8.8.5) with ESMTP id HAA21315; Tue, 24 Aug 1999 07:23:15 -0400 (EDT) Received: (from rivers@localhost) by lakes.dignus.com (8.9.2/8.6.9) id HAA59303; Tue, 24 Aug 1999 07:23:13 -0400 (EDT) Date: Tue, 24 Aug 1999 07:23:13 -0400 (EDT) From: Thomas David Rivers Message-Id: <199908241123.HAA59303@lakes.dignus.com> To: k4n@hotmail.com, roelof@nisser.com Subject: Re: FreeBSD webdesign Cc: freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG In-Reply-To: <199908240628.XAA04813@gilliam.users.flyingcroc.net> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > > k4n _ wrote: > > > > I thought maybe you would be interested in a free website redesign(or > > something) so I downloaded the HTML for your site, and made a few changes. I > > made the background black, redid the FreeBSD logo slightly, and darkened the > > logos at the bottom to match the color scheme. If you are interested I can > > send you a copy, I think it looks pretty cool. See you later > > Why do people always assume that dark is cool. The purpose of a website > is to convey information. Let me add to this that we decided on paper that the background should be white, and the print blank. In fact, we usually go to a lot of trouble to make the paper as white as possible. I wonder why so many people feel differently for computer text? Also - I have several acquaintances with vision problems. Some tell me that besides a small font, a dark background with light text is the most difficult to read. Others tell me its preferable. What this points to is the ability to be as generic as possible, and let the reader decide... Just some random morning thoughts... - Dave Rivers - -- rivers@dignus.com Work: (919) 676-0847 Get your mainframe (370) `C' compiler at http://www.dignus.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 4:31: 2 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 3B8F81509F for ; Tue, 24 Aug 1999 04:30:54 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA86345; Tue, 24 Aug 1999 04:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from reason.ruh-bath.swest.nhs.uk (hide14.nhs.uk [194.6.81.14]) by hub.freebsd.org (Postfix) with ESMTP id 50E7415088 for ; Tue, 24 Aug 1999 04:21:31 -0700 (PDT) (envelope-from rich@reason.ruh-bath.swest.nhs.uk) Received: by reason.ruh-bath.swest.nhs.uk (Postfix, from userid 1001) id 2B5E5BB; Tue, 24 Aug 1999 12:23:46 +0000 (GMT) Message-Id: <19990824122346.2B5E5BB@reason.ruh-bath.swest.nhs.uk> Date: Tue, 24 Aug 1999 12:23:46 +0000 (GMT) From: rich@FreeBSD.org.uk Reply-To: rich@FreeBSD.org.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13348: Corrections to URLs in handbook Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13348 >Category: docs >Synopsis: Corrections to URLs in handbook >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: Tue Aug 24 04:30:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Rich Wood >Release: FreeBSD-Current >Organization: >Environment: Corrections to URLs in US Handbook >Description: Corrections to URLs in US Handbook >How-To-Repeat: >Fix: Patch against US DOCKBOOK Handbook diff -u1 -r handbook.orig/bibliography/chapter.sgml handbook/bibliography/chapter.sgml --- handbook.orig/bibliography/chapter.sgml Tue Aug 24 12:11:52 1999 +++ handbook/bibliography/chapter.sgml Tue Aug 24 12:11:15 1999 @@ -72,3 +72,3 @@ Complete FreeBSD, published by Walnut Creek CDROM. + URL="http://www.cdrom.com/">Walnut Creek CDROM. diff -u1 -r handbook.orig/book.sgml handbook/book.sgml --- handbook.orig/book.sgml Tue Aug 24 12:12:23 1999 +++ handbook/book.sgml Tue Aug 24 12:11:46 1999 @@ -58,3 +58,3 @@ options from the FreeBSD FTP + url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP server or one of the numerous ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming. + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/">ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/. @@ -751,3 +751,3 @@ - &a.mbarkah and his employer, + &a.mbarkah and his employer, Hemisphere Online, donated a Pentium Pro @@ -757,3 +757,3 @@ - ASA + ASA Computers donated a Tyan 1662 @@ -764,3 +764,3 @@ Joe McGuckin joe@via.net of ViaNet Communications donated + URL="http://www.via.ne/t">ViaNet Communications donated a Kingston ethernet controller. @@ -776,3 +776,3 @@ Ulf Zimmermann ulf@Alameda.net of Alameda Networks donated + URL="http://www.Alameda.net/">Alameda Networks donated 128MB of memory, a 4 Gb disk @@ -831,3 +831,3 @@ Kenneth P. Stox ken@stox.sa.enteract.com of - Imaginary Landscape, + Imaginary Landscape, LLC. @@ -932,3 +932,3 @@ - Tekram + Tekram Technologies sent one each of their DC-390, DC-390U @@ -938,3 +938,3 @@ operating systems available from their FTP server ftp://ftp.tekram.com/scsi/FreeBSD. + URL="ftp://ftp.tekram.com/scsi/FreeBSD/">ftp://ftp.tekram.com/scsi/FreeBSD/. @@ -963,3 +963,3 @@ - Walnut Creek CDROM + Walnut Creek CDROM has donated almost more than we can say (see the - The interface + The interface business GmbH, Dresden has been patiently supporting @@ -986,3 +986,3 @@ - Berkeley Software Design, + Berkeley Software Design, Inc. has contributed their DOS emulator code to the diff -u1 -r handbook.orig/cutting-edge/chapter.sgml handbook/cutting-edge/chapter.sgml --- handbook.orig/cutting-edge/chapter.sgml Tue Aug 24 12:11:55 1999 +++ handbook/cutting-edge/chapter.sgml Tue Aug 24 12:11:18 1999 @@ -229,3 +229,3 @@ have installed the most recent release (&rel.current;-RELEASE + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/&rel.current;-RELEASE/">&rel.current;-RELEASE/ at the time of this writing) since the stable @@ -315,3 +315,3 @@ FreeBSD-stable is always “exported” on: ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/ @@ -721,3 +721,3 @@ - Cyclic Software, + Cyclic Software, commercial maintainers of CVS. @@ -790,3 +790,3 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/">ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/ @@ -798,3 +798,3 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/ @@ -1198,3 +1198,3 @@ supfiles in the directory /usr/share/examples/cvsup. + URL="file:/usr/share/examples/cvsup/">/usr/share/examples/cvsup/. These examples are also available from http://freebsd.advansys.net/ — USA/Indiana. + url="http://FreeBSD.advansys.net/">http://FreeBSD.advansys.net/ — USA/Indiana. diff -u1 -r handbook.orig/hw/chapter.sgml handbook/hw/chapter.sgml --- handbook.orig/hw/chapter.sgml Tue Aug 24 12:11:59 1999 +++ handbook/hw/chapter.sgml Tue Aug 24 12:11:22 1999 @@ -83,3 +83,3 @@ For the Pentium II, I'm rather partial to the ASUS ASUS P2l97-S @@ -108,5 +108,5 @@ This one is a bit trickier, and while I used to recommend the - Buslogic controllers + Buslogic controllers unilaterally for everything from ISA to PCI, now I tend to lean - towards the Adaptec + towards the Adaptec 1542CF for ISA, Buslogic Bt747c for EISA and Adaptec 2940UW for @@ -154,6 +154,6 @@ My SCSI preferences extend to SCSI CDROM drives as well, and - while the Toshiba drives + while the Toshiba drives have always been favourites of mine (in whatever speed is hot that week), I'm still fond of my good old Plextor PX-12CS drive. It's + ="http://www.plextor.com/">Plextor PX-12CS drive. It's only a 12 speed, but it's offered excellent performance and @@ -192,6 +192,6 @@ drives from Exabyte and Exabyte and 4mm (DAT) drives from HP. + URL="http://www.hp.com/">HP. @@ -266,3 +266,3 @@ series, with drivers now in FreeBSD-current. Emerging Technologies also + URL="http://www.etinc.com/">Emerging Technologies also manufactures a board with T1/E1 capabilities, using software they diff -u1 -r handbook.orig/introduction/chapter.sgml handbook/introduction/chapter.sgml --- handbook.orig/introduction/chapter.sgml Tue Aug 24 12:12:02 1999 +++ handbook/introduction/chapter.sgml Tue Aug 24 12:11:25 1999 @@ -381,3 +381,3 @@ accommodated, and they are free to use our FTP facilities at ftp.FreeBSD.org + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/">ftp.FreeBSD.org to distribute their own patches or work-in-progress sources. The @@ -575,3 +575,3 @@ copies at http://www.FreeBSD.org. + URL="http://www.FreeBSD.org/">http://www.FreeBSD.org/. diff -u1 -r handbook.orig/mirrors/chapter.sgml handbook/mirrors/chapter.sgml --- handbook.orig/mirrors/chapter.sgml Tue Aug 24 12:12:10 1999 +++ handbook/mirrors/chapter.sgml Tue Aug 24 12:11:33 1999 @@ -35,3 +35,3 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD. + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/. @@ -92,3 +92,3 @@ ftp://ftp.ar.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.ar.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ar.FreeBSD.org/pub/FreeBSD/ @@ -108,3 +108,3 @@ ftp://ftp.au.FreeBSD.org/pub/FreeBSD + ="ftp://ftp.au.FreeBSD.org/pub/FreeBSD/">ftp://ftp.au.FreeBSD.org/pub/FreeBSD/ @@ -113,3 +113,3 @@ ftp://ftp2.au.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.au.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.au.FreeBSD.org/pub/FreeBSD/ @@ -118,3 +118,3 @@ ftp://ftp3.au.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.au.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.au.FreeBSD.org/pub/FreeBSD/ @@ -123,3 +123,3 @@ ftp://ftp4.au.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.au.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.au.FreeBSD.org/pub/FreeBSD/ @@ -139,3 +139,3 @@ ftp://ftp.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp.br.FreeBSD.org/pub/FreeBSD/ @@ -144,3 +144,3 @@ ftp://ftp2.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.br.FreeBSD.org/pub/FreeBSD/ @@ -149,3 +149,3 @@ ftp://ftp3.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.br.FreeBSD.org/pub/FreeBSD/ @@ -154,3 +154,3 @@ ftp://ftp4.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.br.FreeBSD.org/pub/FreeBSD/ @@ -159,3 +159,3 @@ ftp://ftp5.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp5.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp5.br.FreeBSD.org/pub/FreeBSD/ @@ -164,3 +164,3 @@ ftp://ftp6.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp6.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp6.br.FreeBSD.org/pub/FreeBSD/ @@ -169,3 +169,3 @@ ftp://ftp7.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp7.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp7.br.FreeBSD.org/pub/FreeBSD/ @@ -185,3 +185,3 @@ ftp://ftp.ca.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.ca.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ca.FreeBSD.org/pub/FreeBSD/ @@ -201,3 +201,3 @@ ftp://ftp.cn.FreeBSD.org/pub/FreeBSD + url="ftp://ftp.cn/FreeBSD.org/pub/FreeBSD/">ftp://ftp.cn.FreeBSD.org/pub/FreeBSD/ @@ -217,3 +217,3 @@ ftp://ftp.cz.FreeBSD.org Contact: calda@dzungle.ms.mff.cuni.cz + URL="ftp://ftp.cz.FreeBSD.org/pub/FreeBSD/">ftp://ftp.cz.FreeBSD.org Contact: calda@dzungle.ms.mff.cuni.cz @@ -221,3 +221,3 @@ ftp://sunsite.mff.cuni.cz/OS/FreeBSD Contact: jj@sunsite.mff.cuni.cz. + URL="ftp://sunsite.mff.cuni.cz/OS/FreeBSD/">ftp://sunsite.mff.cuni.cz/OS/FreeBSD/ Contact: jj@sunsite.mff.cuni.cz. @@ -237,3 +237,3 @@ ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD + URL="ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD/">ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD/ @@ -253,3 +253,3 @@ ftp://ftp.ee.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.ee.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ee.FreeBSD.org/pub/FreeBSD/ @@ -269,3 +269,3 @@ ftp://ftp.fi.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.fi.FreeBSD.org/pub/FreeBSD/">ftp://ftp.fi.FreeBSD.org/pub/FreeBSD/ @@ -285,3 +285,3 @@ ftp://ftp.fr.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.fr.FreeBSD.org/pub/FreeBSD/">ftp://ftp.fr.FreeBSD.org/pub/FreeBSD/ @@ -292,3 +292,3 @@ ftp://ftp2.fr.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.fr.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.fr.FreeBSD.org/pub/FreeBSD/ @@ -299,3 +299,3 @@ ftp://ftp3.fr.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.fr.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.fr.FreeBSD.org/pub/FreeBSD/ @@ -315,3 +315,3 @@ ftp://ftp.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp.de.FreeBSD.org/pub/FreeBSD/ @@ -320,3 +320,3 @@ ftp://ftp2.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.de.FreeBSD.org/pub/FreeBSD/ @@ -325,3 +325,3 @@ ftp://ftp3.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.de.FreeBSD.org/pub/FreeBSD/ @@ -330,3 +330,3 @@ ftp://ftp4.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.de.FreeBSD.org/pub/FreeBSD/ @@ -335,3 +335,3 @@ ftp://ftp5.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ @@ -340,3 +340,3 @@ ftp://ftp6.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp6.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp6.de.FreeBSD.org/pub/FreeBSD/ @@ -345,3 +345,3 @@ ftp://ftp7.de.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/">ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ @@ -359,3 +359,3 @@ ftp://ftp.hk.super.net/pub/FreeBSD Contact: ftp-admin@HK.Super.NET. + URL="ftp://ftp.hk.super.net/pub/FreeBSD/">ftp://ftp.hk.super.net/pub/FreeBSD/ Contact: ftp-admin@HK.Super.NET. @@ -375,3 +375,3 @@ ftp://ftp.ie.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.ie.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ie.FreeBSD.org/pub/FreeBSD/ @@ -391,3 +391,3 @@ ftp://ftp.il.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.il.FreeBSD.org/pub/FreeBSD/">ftp://ftp.il.FreeBSD.org/pub/FreeBSD/ @@ -396,3 +396,3 @@ ftp://ftp2.il.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.il.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.il.FreeBSD.org/pub/FreeBSD/ @@ -412,3 +412,3 @@ ftp://ftp.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.jp.FreeBSD.org/pub/FreeBSD/ @@ -417,3 +417,3 @@ ftp://ftp2.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.jp.FreeBSD.org/pub/FreeBSD/ @@ -422,3 +422,3 @@ ftp://ftp3.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.jp.FreeBSD.org/pub/FreeBSD/ @@ -427,3 +427,3 @@ ftp://ftp4.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.jp.FreeBSD.org/pub/FreeBSD/ @@ -432,3 +432,3 @@ ftp://ftp5.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp5.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp5.jp.FreeBSD.org/pub/FreeBSD/ @@ -437,3 +437,3 @@ ftp://ftp6.jp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp6.jp.FreeBSD.org/pub/FreeBSD/">ftp://ftp6.jp.FreeBSD.org/pub/FreeBSD/ @@ -453,3 +453,3 @@ ftp://ftp.kr.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.kr.FreeBSD.org/pub/FreeBSD/">ftp://ftp.kr.FreeBSD.org/pub/FreeBSD/ @@ -458,3 +458,3 @@ ftp://ftp2.kr.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.kr.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.kr.FreeBSD.org/pub/FreeBSD/ @@ -462,3 +462,3 @@ - ftp://ftp3.kr.FreeBSD.org/pub/FreeBSD + ftp://ftp3.kr.FreeBSD.org/pub/FreeBSD/ @@ -466,3 +466,3 @@ - ftp://ftp4.kr.FreeBSD.org/pub/FreeBSD + ftp://ftp4.kr.FreeBSD.org/pub/FreeBSD/ @@ -470,3 +470,3 @@ - ftp://ftp5.kr.FreeBSD.org/pub/FreeBSD + ftp://ftp5.kr.FreeBSD.org/pub/FreeBSD/ @@ -475,3 +475,3 @@ ftp://ftp6.kr.FreeBSD.org/pub/FreeBSD + url="ftp://ftp6.kr.FreeBSD.org/pub/FreeBSD/">ftp://ftp6.kr.FreeBSD.org/pub/FreeBSD/ @@ -491,3 +491,3 @@ ftp://ftp.nl.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.nl.FreeBSD.org/pub/FreeBSD/">ftp://ftp.nl.FreeBSD.org/pub/FreeBSD/ @@ -506,3 +506,3 @@ - ftp://ftp.nz.FreeBSD.org/pub/FreeBSD + ftp://ftp.nz.FreeBSD.org/pub/FreeBSD/ @@ -522,3 +522,3 @@ ftp://ftp.pl.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.pl.FreeBSD.org/pub/FreeBSD/">ftp://ftp.pl.FreeBSD.org/pub/FreeBSD/ @@ -538,3 +538,3 @@ ftp://ftp.pt.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.pt.FreeBSD.org/pub/FreeBSD/">ftp://ftp.pt.FreeBSD.org/pub/FreeBSD/ @@ -543,3 +543,3 @@ ftp://ftp2.pt.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.pt.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.pt.FreeBSD.org/pub/FreeBSD/ @@ -559,3 +559,3 @@ ftp://ftp.ru.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.ru.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ru.FreeBSD.org/pub/FreeBSD/ @@ -564,3 +564,3 @@ ftp://ftp2.ru.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.ru.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.ru.FreeBSD.org/pub/FreeBSD/ @@ -569,3 +569,3 @@ ftp://ftp3.ru.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.ru.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.ru.FreeBSD.org/pub/FreeBSD/ @@ -573,3 +573,3 @@ - ftp://ftp4.ru.FreeBSD.org/pub/FreeBSD + ftp://ftp4.ru.FreeBSD.org/pub/FreeBSD/ @@ -588,3 +588,3 @@ ftp://ftp.isu.net.sa/pub/mirrors/ftp.freebsd.org + URL="ftp://ftp.isu.net.sa/pub/mirrors/ftp.freebsd.org/">ftp://ftp.isu.net.sa/pub/mirrors/ftp.freebsd.org/ @@ -605,3 +605,3 @@ ftp://ftp.za.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/ @@ -610,3 +610,3 @@ ftp://ftp2.za.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.za.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.za.FreeBSD.org/pub/FreeBSD/ @@ -615,3 +615,3 @@ ftp://ftp3.za.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.za.FreeBSD.org/FreeBSD/">ftp://ftp3.za.FreeBSD.org/FreeBSD/ @@ -630,3 +630,3 @@ - ftp://ftp.sk.FreeBSD.org/pub/FreeBSD + ftp://ftp.sk.FreeBSD.org/pub/FreeBSD/ @@ -645,3 +645,3 @@ ftp://ftp.si.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.si.FreeBSD.org/pub/FreeBSD/">ftp://ftp.si.FreeBSD.org/pub/FreeBSD/ @@ -660,3 +660,3 @@ - ftp://ftp.es.FreeBSD.org/pub/FreeBSD + ftp://ftp.es.FreeBSD.org/pub/FreeBSD/ @@ -676,3 +676,3 @@ ftp://ftp.se.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.se.FreeBSD.org/pub/FreeBSD/">ftp://ftp.se.FreeBSD.org/pub/FreeBSD/ @@ -681,3 +681,3 @@ ftp://ftp2.se.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.se.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.se.FreeBSD.org/pub/FreeBSD/ @@ -686,3 +686,3 @@ ftp://ftp3.se.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.se.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.se.FreeBSD.org/pub/FreeBSD/ @@ -702,3 +702,3 @@ ftp://ftp.tw.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.tw.FreeBSD.org/pub/FreeBSD/">ftp://ftp.tw.FreeBSD.org/pub/FreeBSD/ @@ -707,3 +707,3 @@ ftp://ftp2.tw.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.tw.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.tw.FreeBSD.org/pub/FreeBSD/ @@ -712,3 +712,3 @@ ftp://ftp3.tw.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.tw.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.tw.FreeBSD.org/pub/FreeBSD/ @@ -725,3 +725,3 @@ ftp://ftp.nectec.or.th/pub/FreeBSD Contact: ftpadmin@ftp.nectec.or.th. + URL="ftp://ftp.nectec.or.th/pub/FreeBSD/">ftp://ftp.nectec.or.th/pub/FreeBSD/ Contact: ftpadmin@ftp.nectec.or.th. @@ -738,3 +738,3 @@ ftp://ftp.ua.FreeBSD.org/pub/FreeBSD Contact: freebsd-mnt@lucky.net. + URL="ftp://ftp.ua.FreeBSD.org/pub/FreeBSD/">ftp://ftp.ua.FreeBSD.org/pub/FreeBSD/ Contact: freebsd-mnt@lucky.net. @@ -754,3 +754,3 @@ ftp://ftp.uk.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.uk.FreeBSD.org/pub/FreeBSD/">ftp://ftp.uk.FreeBSD.org/pub/FreeBSD/ @@ -759,3 +759,3 @@ ftp://ftp2.uk.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.uk.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.uk.FreeBSD.org/pub/FreeBSD/ @@ -764,3 +764,3 @@ ftp://ftp3.uk.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.uk.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.uk.FreeBSD.org/pub/FreeBSD/ @@ -769,3 +769,3 @@ ftp://ftp4.uk.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.uk.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.uk.FreeBSD.org/pub/FreeBSD/ @@ -785,3 +785,3 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ @@ -790,3 +790,3 @@ ftp://ftp2.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.FreeBSD.org/pub/FreeBSD/ @@ -795,3 +795,3 @@ ftp://ftp3.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp3.FreeBSD.org/pub/FreeBSD/">ftp://ftp3.FreeBSD.org/pub/FreeBSD/ @@ -800,3 +800,3 @@ ftp://ftp4.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp4.FreeBSD.org/pub/FreeBSD/">ftp://ftp4.FreeBSD.org/pub/FreeBSD/ @@ -805,3 +805,3 @@ ftp://ftp5.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp5.FreeBSD.org/pub/FreeBSD/">ftp://ftp5.FreeBSD.org/pub/FreeBSD/ @@ -810,3 +810,3 @@ ftp://ftp6.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp6.FreeBSD.org/pub/FreeBSD/">ftp://ftp6.FreeBSD.org/pub/FreeBSD/ @@ -834,3 +834,3 @@ ftp://ftp.internat.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.internat.FreeBSD.org/pub/FreeBSD/">ftp://ftp.internat.FreeBSD.org/pub/FreeBSD/ @@ -839,3 +839,3 @@ ftp://ftp2.internat.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp2.internat.FreeBSD.org/pub/FreeBSD/">ftp://ftp2.internat.FreeBSD.org/pub/FreeBSD/ @@ -855,3 +855,3 @@ ftp://ftp.br.FreeBSD.org/pub/FreeBSD + URL="ftp://ftp.br.FreeBSD.org/pub/FreeBSD/">ftp://ftp.br.FreeBSD.org/pub/FreeBSD/ @@ -868,3 +868,3 @@ ftp://nic.funet.fi/pub/unix/FreeBSD/eurocrypt Contact: count@nic.funet.fi. + URL="ftp://nic.funet.fi/pub/unix/FreeBSD/eurocrypt/">ftp://nic.funet.fi/pub/unix/FreeBSD/eurocrypt/ Contact: count@nic.funet.fi. @@ -893,3 +893,3 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/ @@ -906,3 +906,3 @@ ftp://ftp.uni-trier.de/pub/unix/systems/BSD/FreeBSD/CTM + URL="ftp://ftp.uni-trier.de/pub/unix/systems/BSD/FreeBSD/CTM/">ftp://ftp.uni-trier.de/pub/unix/systems/BSD/FreeBSD/CTM/ @@ -919,3 +919,3 @@ ftp://ftp.internat.FreeBSD.org/pub/FreeBSD/CTM + URL="ftp://ftp.internat.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.internat.FreeBSD.org/pub/FreeBSD/CTM/ @@ -932,3 +932,3 @@ ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/CTM + URL="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/CTM/ @@ -937,3 +937,3 @@ ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/CTM + URL="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/CTM/ @@ -942,3 +942,3 @@ ftp://ctm3.tw.FreeBSD.org/pub/freebsd/CTM + URL="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ctm3.tw.FreeBSD.org/pub/freebsd/CTM/ @@ -1466,3 +1466,3 @@ The path to the files are: - /afs/stacken.kth.se/ftp/pub/FreeBSD + /afs/stacken.kth.se/ftp/pub/FreeBSD/ diff -u1 -r handbook.orig/ports/chapter.sgml handbook/ports/chapter.sgml --- handbook.orig/ports/chapter.sgml Tue Aug 24 12:12:14 1999 +++ handbook/ports/chapter.sgml Tue Aug 24 12:11:37 1999 @@ -107,5 +107,5 @@ If you look at a port skeleton (either on your FreeBSD + URL="file://localhost/usr/ports/devel/ElectricFence/">your FreeBSD system or the + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/ports/devel/ElectricFence/">the FTP site) and expect to find all sorts of pointy-headed rocket diff -u1 -r handbook.orig/printing/chapter.sgml handbook/printing/chapter.sgml --- handbook.orig/printing/chapter.sgml Tue Aug 24 12:12:16 1999 +++ handbook/printing/chapter.sgml Tue Aug 24 12:11:40 1999 @@ -4543,3 +4543,3 @@ for the software is at ftp://ftp.iona.ie/pub/plp. + URL="ftp://ftp.iona.ie/pub/plp/">ftp://ftp.iona.ie/pub/plp/. There is also a ftp://dickory.sdsu.edu/pub/LPRng. + URL="ftp://dickory.sdsu.edu/pub/LPRng/">ftp://dickory.sdsu.edu/pub/LPRng/. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 5:32:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 267E5150D0 for ; Tue, 24 Aug 1999 05:32:31 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id FAA89912; Tue, 24 Aug 1999 05:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 05:30:02 -0700 (PDT) Message-Id: <199908241230.FAA89912@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Chris Costello Subject: Re: docs/13348: Corrections to URLs in handbook Reply-To: Chris Costello Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13348; it has been noted by GNATS. From: Chris Costello To: rich@FreeBSD.org.uk Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/13348: Corrections to URLs in handbook Date: Tue, 24 Aug 1999 07:21:11 -0500 On Tue, Aug 24, 1999, rich@FreeBSD.org.uk wrote: > >Number: 13348 > >Synopsis: Corrections to URLs in handbook > - URL="http://www.via.net">ViaNet Communications donated > + URL="http://www.via.ne/t">ViaNet Communications donated ^^^^^^^^^^^^^^^^^^^ Typo! :) > @@ -229,3 +229,3 @@ > have installed the most recent release ( - URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/&rel.current;-RELEASE">&rel.current;-RELEASE > + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/&rel.current;-RELEASE/">&rel.current;-RELEASE/ There is no `3.2-RELEASE/' version of FreeBSD. > - url="http://freebsd.advansys.net/">http://freebsd.advansys.net/ — USA/Indiana. > + url="http://FreeBSD.advansys.net/">http://FreeBSD.advansys.net/ — USA/Indiana. ^^^^^^^ What's the opinion on `freebsd' in other, non-FreeBSD.org hostnames? > week), I'm still fond of my good old - url="http://www.plextor.com">Plextor PX-12CS drive. It's > + ="http://www.plextor.com/">Plextor PX-12CS drive. It's ^^^^^^^^^^^^^^^^^^^^^^^^^^ Where is "url"? > only a 12 speed, but it's offered excellent performance and > @@ -192,6 +192,6 @@ > drives from - URL="http://www.exabyte.com">Exabyte and + URL="http://www.exabyte.com/">Exabyte and URL="http://www-dmo.external.hp.com:80/tape/_cpb0001.htm">4mm > (DAT) drives from - URL="http://www.hp.com">HP. > + URL="http://www.hp.com/">HP. (Actually, `URL' should be `url' here, but that's not your fault. :) > - URL="ftp://ftp.au.FreeBSD.org/pub/FreeBSD">ftp://ftp.au.FreeBSD.org/pub/FreeBSD > + ="ftp://ftp.au.FreeBSD.org/pub/FreeBSD/">ftp://ftp.au.FreeBSD.org/pub/FreeBSD/ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ `url' missing > - URL="ftp://ftp.cz.FreeBSD.org/pub/FreeBSD">ftp://ftp.cz.FreeBSD.org Contact: calda@dzungle.ms.mff.cuni.cz > + URL="ftp://ftp.cz.FreeBSD.org/pub/FreeBSD/">ftp://ftp.cz.FreeBSD.org Contact: calda@dzungle.ms.mff.cuni.cz > > @@ -221,3 +221,3 @@ > - URL="ftp://sunsite.mff.cuni.cz/OS/FreeBSD">ftp://sunsite.mff.cuni.cz/OS/FreeBSD Contact: jj@sunsite.mff.cuni.cz. > + URL="ftp://sunsite.mff.cuni.cz/OS/FreeBSD/">ftp://sunsite.mff.cuni.cz/OS/FreeBSD/ Contact: jj@sunsite.mff.cuni.cz. > > @@ -237,3 +237,3 @@ > - URL="ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD">ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD > + URL="ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD/">ftp://ftp.dk.freeBSD.ORG/pub/FreeBSD/ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yow! I will fix this separately. `FreeBSD.ORG' was supposed to be changed to `FreeBSD.org' and I recall fixing it. Something slipped past me. In closing, I'd like you to CVSup your doc/ tree and look at this again, and submit a better and newer patch as a follow-up to this problem report. I believe I recall seeing somebody having fixed trailing slashed on some URLs in the handbook before, recently, and I'm going to work on the `URL=' and `FreeBSD.ORG' problems too. Thanks! -- |Chris Costello |Everybody needs a little love sometime; stop hacking and fall in love! `---------------------------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 6: 0: 7 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id AAE9915162 for ; Tue, 24 Aug 1999 06:00:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id GAA91686; Tue, 24 Aug 1999 06:00:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 3542F15152 for ; Tue, 24 Aug 1999 05:59:46 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 77940 invoked by uid 1003); 24 Aug 1999 13:00:37 -0000 Message-Id: <19990824130037.77939.qmail@rucus.ru.ac.za> Date: 24 Aug 1999 13:00:37 -0000 From: nbm@rucus.ru.ac.za Reply-To: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13349: fix xref to ANCHOR in English FAQ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13349 >Category: docs >Synopsis: fix xref to ANCHOR in English FAQ >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Aug 24 06:00:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Neil Blakey-Milner >Release: FreeBSD 3.0-STABLE i386 >Organization: Rhodes University Computer Users' Society >Environment: FreeBSD rucus.ru.ac.za 3.0-STABLE FreeBSD 3.0-STABLE #0: Tue Feb 9 22:52:23 GMT 1999 grahams@rucus.ru.ac.za:/usr/src/sys/compile/RUCUS-SMP i386 >Description: change external references to internal links, which seems to make things build without warnings, and generates useful html. >How-To-Repeat: build the FAQ and note links to Xi Graphics internally don't work in x.html to commercial.html >Fix: Index: book.sgml =================================================================== RCS file: /home/nbm/ncvs/doc/en_US.ISO_8859-1/books/faq/book.sgml,v retrieving revision 1.2 diff -u -r1.2 book.sgml --- book.sgml 1999/08/18 19:16:52 1.2 +++ book.sgml 1999/08/23 18:20:46 @@ -1200,7 +1200,7 @@ -See also on the Mobile Computing page. +See also this note on the Mobile Computing page. @@ -1721,8 +1721,8 @@ Parallel Port drive should be available as /dev/da0s4. Disks can be mounted using mount /dev/da0s4 /mnt OR (for dos disks) mount_msdos /dev/da0s4 /mnt as appropriate. -Also check out , -and . +Also check out this note on removable drives, +and this note on 'formatting'. @@ -1739,7 +1739,7 @@ drive before swapping media, and make sure that any external units are powered on when you boot the system so FreeBSD can see them. -See . +See this note on 'formatting'. @@ -1903,7 +1903,7 @@ How do I use the mouse/trackball/touchpad on my laptop? -Please refer to . And check out on the Mobile +Please refer to the answer to the previous question. And check out this note on the Mobile Computing page. @@ -2280,7 +2280,7 @@ Hopefully, future versions will have a proper fix for this problem. NOTE: You can not use a dangerously dedicated disk with -an HP Netserver. See for +an HP Netserver. See this note for more info. @@ -2678,7 +2678,7 @@ Where can I get Motif for FreeBSD? -Contact for an ELF Motif 2.1 +Contact Apps2go for an ELF Motif 2.1 distribution for FreeBSD. This distribution includes: @@ -2744,7 +2744,7 @@ -Contact for an either ELF or +Contact Metro Link for an either ELF or a.out Motif 2.1 distribution for FreeBSD. This distribution includes: @@ -2784,7 +2784,7 @@ Metro Link. This is available on either a CDROM or for FTP download. -Contact for an a.out Motif 2.0 +Contact Xi Graphics for an a.out Motif 2.0 distribution for FreeBSD. This distribution includes: @@ -2829,7 +2829,7 @@ Where can I get CDE for FreeBSD? - used to sell CDE for +Xi Graphics used to sell CDE for FreeBSD, but no longer do. KDE is an open source @@ -2844,7 +2844,7 @@ Yes, Xi Graphics and Metro Link sells Accelerated-X product for FreeBSD and other Intel based systems. - + The Metro Link offering is a high performance X Server that offers easy configuration using the FreeBSD Package suite of tools, support @@ -2892,7 +2892,7 @@ for multiple concurrent video boards and is distributed in binary form only, in a unified diskette distribution for FreeBSD and Linux. Xi Graphics also offers a high performance X Server taylored for -laptop support. +laptop support. There is a free "compatibility demo" of version 5.0 available. @@ -4539,8 +4539,8 @@ for your particular graphics card/mouse/etc. You may also wish to investigate the Xaccel server. -See the section on or - for more details. +See the section on Xi Graphics or +Metro Link for more details. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 6:47:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 4CA7E15152; Tue, 24 Aug 1999 06:47:38 -0700 (PDT) (envelope-from chris@FreeBSD.org) Received: (from chris@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id GAA95217; Tue, 24 Aug 1999 06:47:34 -0700 (PDT) (envelope-from chris@FreeBSD.org) Date: Tue, 24 Aug 1999 06:47:34 -0700 (PDT) From: Message-Id: <199908241347.GAA95217@freefall.freebsd.org> To: chris@FreeBSD.org, freebsd-doc@FreeBSD.org, chris@FreeBSD.org Subject: Re: docs/13348: Corrections to URLs in handbook Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Corrections to URLs in handbook Responsible-Changed-From-To: freebsd-doc->chris Responsible-Changed-By: chris Responsible-Changed-When: Tue Aug 24 06:47:19 PDT 1999 Responsible-Changed-Why: Working on it. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 9:15:34 1999 Delivered-To: freebsd-doc@freebsd.org Received: from fellspt.charm.net (fellspt.charm.net [199.0.70.29]) by hub.freebsd.org (Postfix) with ESMTP id 3E20E14C1F; Tue, 24 Aug 1999 09:15:19 -0700 (PDT) (envelope-from dutch@charm.net) Received: from charm.net (coretel-115-028.charm.net [209.143.115.28]) by fellspt.charm.net (8.9.3/8.9.3) with ESMTP id MAA13479; Tue, 24 Aug 1999 12:15:17 -0400 (EDT) Message-ID: <37C2C4F1.B95AFE48@charm.net> Date: Tue, 24 Aug 1999 12:14:41 -0400 From: Dutch Collins X-Mailer: Mozilla 4.61 [en] (X11; I; FreeBSD 3.2-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: jkoshy@FreeBSD.ORG Cc: freebsd-doc@FreeBSD.ORG Subject: Re: New FAQ entry References: <199908240911.CAA76582@freefall.freebsd.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org jkoshy@FreeBSD.ORG wrote: > > Comments solicited on the following FAQ entry: > > ---------------------------------------------------------------- > Q: Can ordinary users mount floppies and other removable media? > > A: Yes, they can, but this feature is not enabled by default in FreeBSD. > Here is how to allow non-root users to mount devices: > > 1. As `root' assign the appropriate permissions to the block > device associated with the removable media. For example, > for floppies: > > # chmod 777 /dev/fd0 > > 2. As 'root' set the sysctl variable 'vfs.usermount' to '1'. > > # sysctl -w vfs.usermount=1 > > Users can now mount '/dev/fd0' onto any directory that they own: > > 3. $ mkdir ~/my-mount-point > $ mount -t msdos /dev/fd0 ~/my-mount-point > > Unmounting the device is simple: > > 4. $ umount ~/my-mount-point > > ---------------------------------------------------------------- > > Regards, > Koshy > > Comment on; I use use the following. Not that I am too lazy but, I haven't had time to try the FAQ yet. Ok, I will open another konsole. # mount_msdos /dev/fd0 /floppy to unmount # umount /floppy -d ---- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 9:21:15 1999 Delivered-To: freebsd-doc@freebsd.org Received: from curlew.cs.man.ac.uk (curlew.cs.man.ac.uk [130.88.13.7]) by hub.freebsd.org (Postfix) with ESMTP id 38AF6159C4; Tue, 24 Aug 1999 09:20:12 -0700 (PDT) (envelope-from Networks.Manager@rncm.ac.uk) Received: from fs3.rncm.ac.uk ([193.63.96.102] helo=rncm.ac.uk) by curlew.cs.man.ac.uk with esmtp (Exim 1.92 #3) id 11JI7P-0001mq-00; Tue, 24 Aug 1999 16:04:11 +0100 Received: from RNCM-FS3/SpoolDir by rncm.ac.uk (Mercury 1.44); 24 Aug 99 16:04:15 GMT Received: from SpoolDir by RNCM-FS3 (Mercury 1.44); 24 Aug 99 16:04:09 GMT Received: from selene (193.63.96.96) by rncm.ac.uk (Mercury 1.44); 24 Aug 99 16:04:06 GMT From: "Peter McGarvey" To: "Thomas David Rivers" , , Cc: , Subject: RE: FreeBSD webdesign Date: Tue, 24 Aug 1999 16:04:05 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2910.0) In-Reply-To: <199908241123.HAA59303@lakes.dignus.com> X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3155.0 Importance: Normal Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Web styles/colour schemes are something I feel strongly about. I'm dyslexic. A bad colour scheme make my life hell. Personally I find Black on White difficult to read. When I'm trying to read along a line my eyes sort of "fall off". To get around this I have to peer at the sceen intently and usually end up getting a headache. Black on Light Grey is much nicer. Blue on Black is 100% impossible to read. Bigger bolder fonts help. However, instead of arguing the toss about personal preferance in colour, why not investigate a method of allowing users to overide colours and font styles. Much more user friendly. TTFN, FNORD -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Peter McGarvey, Networks Manager | email: Networks.Manager@rncm.ac.uk Royal Northern College of Music | tel: +44 (0)161 907 5218 124 Oxford Road, Manchester, | fax: +44 (0)161 273 7611 England M13 9RD | mobile: +44 (0)7887 990564 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- > -----Original Message----- > From: owner-freebsd-questions@FreeBSD.ORG > [mailto:owner-freebsd-questions@FreeBSD.ORG]On Behalf Of Thomas David > Rivers > Sent: 24 August 1999 12:23 > To: k4n@hotmail.com; roelof@nisser.com > Cc: freebsd-doc@FreeBSD.ORG; freebsd-questions@FreeBSD.ORG > Subject: Re: FreeBSD webdesign > > > > > > k4n _ wrote: > > > > > > I thought maybe you would be interested in a free website redesign(or > > > something) so I downloaded the HTML for your site, and made > a few changes. I > > > made the background black, redid the FreeBSD logo slightly, > and darkened the > > > logos at the bottom to match the color scheme. If you are > interested I can > > > send you a copy, I think it looks pretty cool. See you later > > > > Why do people always assume that dark is cool. The purpose of a website > > is to convey information. > > Let me add to this that we decided on paper that the background should > be white, and the print blank. In fact, we usually go to a lot of > trouble to make the paper as white as possible. I wonder why > so many people > feel differently for computer text? > > Also - I have several acquaintances with vision problems. Some tell me > that besides a small font, a dark background with light text is the > most difficult to read. Others tell me its preferable. > > What this points to is the ability to be as generic as possible, and > let the reader decide... > > Just some random morning thoughts... > > - Dave Rivers - > -- > rivers@dignus.com Work: (919) 676-0847 > Get your mainframe (370) `C' compiler at http://www.dignus.com > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-questions" in the body of the message To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 9:21:34 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id B5059159D2; Tue, 24 Aug 1999 09:20:52 -0700 (PDT) (envelope-from chris@FreeBSD.org) Received: (from chris@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA96862; Tue, 24 Aug 1999 07:20:04 -0700 (PDT) (envelope-from chris@FreeBSD.org) Date: Tue, 24 Aug 1999 07:20:04 -0700 (PDT) From: Message-Id: <199908241420.HAA96862@freefall.freebsd.org> To: chris@FreeBSD.org, freebsd-bugs@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: misc/13341: FAQ 8.7 addition - booting drive 1 from NT loader Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: FAQ 8.7 addition - booting drive 1 from NT loader Responsible-Changed-From-To: freebsd-bugs->freebsd-doc Responsible-Changed-By: chris Responsible-Changed-When: Tue Aug 24 07:19:48 PDT 1999 Responsible-Changed-Why: Misfiled PR. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 10: 5:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mta2.rcsntx.swbell.net (mta2.rcsntx.swbell.net [151.164.30.26]) by hub.freebsd.org (Postfix) with ESMTP id D8F5A1618B; Tue, 24 Aug 1999 09:56:39 -0700 (PDT) (envelope-from chris@holly.dyndns.org) Received: from holly.dyndns.org (adsl-216-62-154-215.dsl.hstntx.swbell.net) by mta2.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.1999.05.24.18.28.p7) with ESMTP id <0FGZ0052YATPMZ@mta2.rcsntx.swbell.net>; Tue, 24 Aug 1999 11:51:26 -0500 (CDT) Received: (from chris@localhost) by holly.dyndns.org (8.9.3/8.9.3) id LAA92049; Tue, 24 Aug 1999 11:53:38 -0500 (CDT envelope-from chris) Date: Tue, 24 Aug 1999 11:53:37 -0500 From: Chris Costello Subject: Re: FreeBSD webdesign In-reply-to: To: Peter McGarvey Cc: Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG Reply-To: chris@calldei.com Message-id: <19990824115337.J90868@holly.dyndns.org> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.4i References: <199908241123.HAA59303@lakes.dignus.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999, Peter McGarvey wrote: > However, instead of arguing the toss about personal preferance in colour, > why not investigate a method of allowing users to overide colours and font > styles. Much more user friendly. There's an option for just that in Netscape's preferences window. -- |Chris Costello |CCITT - Can't Conceive Intelligent Thoughts Today `------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 10:15:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 5309315D1F for ; Tue, 24 Aug 1999 10:10:59 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA07856; Tue, 24 Aug 1999 10:10:06 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from reason.ruh-bath.swest.nhs.uk (hide14.nhs.uk [194.6.81.14]) by hub.freebsd.org (Postfix) with ESMTP id 59ABA158BE for ; Tue, 24 Aug 1999 09:55:17 -0700 (PDT) (envelope-from rich@reason.ruh-bath.swest.nhs.uk) Received: by reason.ruh-bath.swest.nhs.uk (Postfix, from userid 1001) id B416CC2; Tue, 24 Aug 1999 16:34:12 +0000 (GMT) Message-Id: <19990824163412.B416CC2@reason.ruh-bath.swest.nhs.uk> Date: Tue, 24 Aug 1999 16:34:12 +0000 (GMT) From: rich@FreeBSD.org.uk Reply-To: rich@FreeBSD.org.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13354: More changes to www/en/gallery/gallery.db Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13354 >Category: docs >Synopsis: URL corrections for www/en/gallery/gallery.db >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: Tue Aug 24 10:10:04 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Rich Wood >Release: FreeBSD 3.2-RELEASE i386 >Organization: >Environment: N/A >Description: URL corrections for www/en/gallery/gallery.db Incorrect URLs either corrected or removed. This (along with my other pr) conclude the commercial entries >How-To-Repeat: N/A >Fix: Due to the size of the patch, it is available at ftp://ftp.dynamite.org/pub/FreeBSD/gallery.db.diff2.gz rather than being included here. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 10:20:54 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gershwin.tera.com (gershwin.tera.com [207.224.230.28]) by hub.freebsd.org (Postfix) with ESMTP id ABEA915D7E; Tue, 24 Aug 1999 10:17:53 -0700 (PDT) (envelope-from kline@tera.com) Received: from athena.tera.com (athena.tera.com [207.224.230.169]) by gershwin.tera.com (8.8.8/8.8.8) with ESMTP id KAA12777; Tue, 24 Aug 1999 10:17:39 -0700 (PDT) Received: (from kline@localhost) by athena.tera.com (8.7.5/8.7.3) id KAA02915; Tue, 24 Aug 1999 10:17:38 -0700 (PDT) Date: Tue, 24 Aug 1999 10:17:38 -0700 From: Gary Kline To: Peter McGarvey Cc: Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG Subject: Re: FreeBSD webdesign Message-ID: <19990824101738.B2875@athena.tera.com> References: <199908241123.HAA59303@lakes.dignus.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95us In-Reply-To: ; from Peter McGarvey on Tue, Aug 24, 1999 at 04:04:05PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 04:04:05PM +0100, Peter McGarvey wrote: > Web styles/colour schemes are something I feel strongly about. > > I'm dyslexic. A bad colour scheme make my life hell. > > Personally I find Black on White difficult to read. When I'm trying > to read along a line my eyes sort of "fall off". To get around this I > have to peer at the sceen intently and usually end up getting a headache. > > Black on Light Grey is much nicer. > > Blue on Black is 100% impossible to read. > > Bigger bolder fonts help. > > However, instead of arguing the toss about personal preferance in colour, > why not investigate a method of allowing users to overide colours and font > styles. Much more user friendly. > > Hm, very interesting. This (black on light grey) may be why so many commercial apps use this scheme. I prefer off-white for the bg and black (bold) fonts, but this may not work for everyone, obviously. Do you know how light the grey can be before you find it hard to read? I've played around with black on grey85 and it's fairly reasonable. I've also experiments with bright green|orange|blue typefaces on black... uhh, no. Has anybody on the list found any websites with presentation information? gary To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 10:21: 0 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 1994015E26 for ; Tue, 24 Aug 1999 10:20:10 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA08438; Tue, 24 Aug 1999 10:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from reason.ruh-bath.swest.nhs.uk (hide14.nhs.uk [194.6.81.14]) by hub.freebsd.org (Postfix) with ESMTP id 5D23115D79 for ; Tue, 24 Aug 1999 10:10:59 -0700 (PDT) (envelope-from rich@reason.ruh-bath.swest.nhs.uk) Received: by reason.ruh-bath.swest.nhs.uk (Postfix, from userid 1001) id 56BD8BD; Tue, 24 Aug 1999 15:30:45 +0000 (GMT) Message-Id: <19990824153045.56BD8BD@reason.ruh-bath.swest.nhs.uk> Date: Tue, 24 Aug 1999 15:30:45 +0000 (GMT) From: rich@FreeBSD.org.uk Reply-To: rich@FreeBSD.org.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13356: Corrections to www/en/gallery/gallery.db Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13356 >Category: docs >Synopsis: Corrections to www/en/gallery/gallery.db >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: Tue Aug 24 10:20:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Rich Wood >Release: FreeBSD 3.2-RELEASE i386 >Organization: >Environment: N/A >Description: Add trailing '/' to appropriate URL's Remove dup's Remove totally incorrect URL's Correct correctable URL's Only corrected entries A-I so far. >How-To-Repeat: N/A >Fix: Due to the size of the diff, it is available at ftp://ftp.dynamite.org/pub/FreeBSD/gallery.db.diff.gz rather than being included here. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:31:25 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id B5EDB15977 for ; Tue, 24 Aug 1999 11:31:14 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25906 for ; Tue, 24 Aug 1999 19:26:38 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA66376 for doc@freebsd.org; Tue, 24 Aug 1999 16:11:54 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 16:11:54 +0100 From: Nik Clayton To: doc@freebsd.org Subject: Re: docs/12684: Correction to your website for ZNYX Corp. Hardware Message-ID: <19990824161154.B65430@kilt.nothing-going-on.org> References: <199908240300.UAA33365@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908240300.UAA33365@freefall.freebsd.org>; from cpiazza@FreeBSD.org on Mon, Aug 23, 1999 at 08:00:50PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 08:00:50PM -0700, cpiazza@FreeBSD.org wrote: > Synopsis: Correction to your website for ZNYX Corp. Hardware > > State-Changed-From-To: open->closed > State-Changed-By: cpiazza > State-Changed-When: Mon Aug 23 20:00:13 PDT 1999 > State-Changed-Why: > This was fixed by nik but he forgot to close the PR, thanks! Oops. Thanks for catching that. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:37:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id E0630150EC for ; Tue, 24 Aug 1999 11:36:38 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25918 for ; Tue, 24 Aug 1999 19:26:39 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id SAA81642 for doc@freebsd.org; Tue, 24 Aug 1999 18:06:38 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 18:06:38 +0100 From: Nik Clayton To: doc@freebsd.org Subject: ToDo Message-ID: <19990824180638.A78397@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Folks, I thought various people might like to see my current ToDo list for the doc/ tree over the next 30 days or so. Partly to get an idea of what's coming up (or might be coming up, assuming it's not contentious) and partly so that interested parties can stick their hands in the air and say that they'd like to do it. Most of the stuff is fairly routine, but if anyone wants to get their hands dirty they're more than welcome to take on one or more of these tasks. * The FAQ The FAQ has now been converted to DocBook, but it's a stop-gap conversion only. The conversion process 'cheats', and leaves a lot of ... lying around the place. It also gets some things wrong, assuming that anything in ALL CAPS is an , and that anything that contains an '@' sign is an e-mail address (amongst many others). What it needs is someone to go through it, line by line, and correct all the markup. It is imperative that this is done without making any whitespace changes, so that it is as easy as possible for translators to follow. If possible, you should try and use automated tools to do the changes, and document how you did them. For example, if you can use a simple search and replace, or some Perl, or some Emacs Lisp to make a change, document how you did it, so that the translation teams can use the same approach. Related to this, the FAQ has stagnated over time -- some of the information in there is undoubtedly wrong, or out of date. Since you're going to be looking at each line of the FAQ anyway, it would be helpful if you could keep notes of anything that looks like it needs to be updated, so that the FAQ maintainers can jump on it. * The articles The articles in doc/en*/articles/* are all marked up as rather than
, and they use the DocBook 3.0 DTD, rather than the FreeBSD 3.1 based extension. These should be converted to
, and use the FreeBSD DTD. Along the way you probably want to take advantage of the &man.xxx.n; entities. * The Device Driver Writer's Guide This is in doc/en*/tutorials/ddwg, and hasn't yet been converted to DocBook. I'm in two minds whether or not it should be. This is because the information in the guide is very out of date, and Jeroen Ruigrok is working on a new one that's up to date. I'm not sure that the effort of converting it to DocBook is worth the usefulness of the information in the guide. I'm more than welcome to be corrected on this, if people actually find the guide useful. * The Pedantic PPP Primer This is in doc/en*/tutorials/ppp, and hasn't been converted to DocBook. This one probably should be converted to DocBook, but someone more familiar than I am with PPP should look it over and see how much of the information in it is still appropriate. It may be that the PPP information in the Handbook is more correct, or it may be that we're better off updating the information in the Handbook from the Primer. Or, it might be a better decision to keep the primer as well. I don't know. If we do decide to keep the primer it should probably be converted to a DocBook , rather than an
(because of its size), and the natural place for it to live would be doc/en*/books/ppp-primer/. * Problems with the Japanese PS and PDF output I am dismayed that Postscript and PDF output from the Japanese documentation is not generated properly. I'm no TeXnician, so all I could do is act as a go-between the Japanese Documentation Project and anyone with the appropriate TeX experience. If someone else wants to take this on, please step up to the plate. There are other tasks as well (for example, bringing in the French translations) but I plan on definitely handling those myself, because I've been working with the appropriate people for some time. Hope that's informative. As I say, if anyone wants to nab one of these tasks for themselves, please say so. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:40: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 874F815033; Tue, 24 Aug 1999 11:39:31 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25921; Tue, 24 Aug 1999 19:26:40 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA76669; Tue, 24 Aug 1999 17:35:39 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:35:39 +0100 From: Nik Clayton To: jkoshy@FreeBSD.org Cc: freebsd-doc@freebsd.org Subject: Re: New FAQ entry Message-ID: <19990824173539.N65430@kilt.nothing-going-on.org> References: <199908240911.CAA76582@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908240911.CAA76582@freefall.freebsd.org>; from jkoshy@FreeBSD.org on Tue, Aug 24, 1999 at 02:11:51AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 02:11:51AM -0700, jkoshy@FreeBSD.org wrote: > Comments solicited on the following FAQ entry: > > ---------------------------------------------------------------- > Q: Can ordinary users mount floppies and other removable media? > > A: Yes, they can, but this feature is not enabled by default in FreeBSD. > Here is how to allow non-root users to mount devices: Looks good. Do you need this DocBook'd, or can you add it yourself? N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:40:16 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 443ED150E5 for ; Tue, 24 Aug 1999 11:40:15 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA14817; Tue, 24 Aug 1999 11:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 11:40:02 -0700 (PDT) Message-Id: <199908241840.LAA14817@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Nik Clayton Subject: Re: docs/13349: fix xref to ANCHOR in English FAQ Reply-To: Nik Clayton Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13349; it has been noted by GNATS. From: Nik Clayton To: nbm@rucus.ru.ac.za Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/13349: fix xref to ANCHOR in English FAQ Date: Tue, 24 Aug 1999 17:43:07 +0100 On Tue, Aug 24, 1999 at 01:00:37PM -0000, nbm@rucus.ru.ac.za wrote: > >Description: > > change external references to internal links, which seems to make things > build without warnings, and generates useful html. Excellent. That was about the third item on my ToDo list. Cheers, I'll be committing this (unless someone beats me to it) very shortly. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:42:15 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 5C6A3150E5 for ; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25927; Tue, 24 Aug 1999 19:26:40 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA68113; Tue, 24 Aug 1999 16:26:02 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 16:26:02 +0100 From: Nik Clayton To: sklimaszewski@walbridge.com Cc: freebsd-doc@freebsd.org Subject: Re: Install Problems - Guides Message-ID: <19990824162602.E65430@kilt.nothing-going-on.org> References: <852567CB.00711E8B.00@notes1.walbridge.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <852567CB.00711E8B.00@notes1.walbridge.com>; from sklimaszewski@walbridge.com on Thu, Aug 12, 1999 at 04:35:33PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Steve, On Thu, Aug 12, 1999 at 04:35:33PM -0400, sklimaszewski@walbridge.com wrote: > My name is Steve, and I am new to FreeBSD. I am attempting to install > FreeBSD 3.2-RELEASE on a HP OmniBook 5000CT laptop. [...] Sorry, but the best place for information about is going to be on the mobile@FreeBSD.org and questions@FreeBSD.org mailing lists. You should also check out the "mobile FreeBSD" web pages, which start at http://www.jp.FreeBSD.org/PAO/ It's possible you may have to download special "PAO" versions of the FreeBSD install floppies before this will work on your laptop. That page also links to a "supported hardware" list, so you can check that your laptop is actually supported. Hope that helps, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:42:25 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 565A8151A9 for ; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25928; Tue, 24 Aug 1999 19:26:40 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA73459; Tue, 24 Aug 1999 17:09:43 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:09:43 +0100 From: Nik Clayton To: Kelly Yancey Cc: doc@freebsd.org Subject: Re: spelling mistakes Message-ID: <19990824170943.H65430@kilt.nothing-going-on.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Kelly Yancey on Thu, Aug 19, 1999 at 09:57:58PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Kelly, On Thu, Aug 19, 1999 at 09:57:58PM -0400, Kelly Yancey wrote: > 1. in the handbook (in the "Making a port yourself" section) it reads: > > As mentioned above, the default target to call when a dependency > is required is DEPENDS_TARGET. It defaults to install. This is a > user variable; is is never defined in a port's Makefile. If your > port needs a special way to handle a dependency, use the :target > part of the *_DEPENDS variables instead of redefining > DEPENDS_TARGET. > > obviously, it should read "it is never defined..." > ^^ Thanks for that. I'll be committing a fix very shortly. I've forwarded your other comment on to the maintainer of the mysql port, so they can fix it. Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:42:55 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 7A249151F2 for ; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25930; Tue, 24 Aug 1999 19:26:41 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA67723; Tue, 24 Aug 1999 16:22:55 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 16:22:55 +0100 From: Nik Clayton To: "Scott D. Lancaster" Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Cable Modem Installs Message-ID: <19990824162255.D65430@kilt.nothing-going-on.org> References: <37B2071D.BC4F7D1F@mediaone.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <37B2071D.BC4F7D1F@mediaone.net>; from Scott D. Lancaster on Wed, Aug 11, 1999 at 06:28:30PM -0500 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Scott, On Wed, Aug 11, 1999 at 06:28:30PM -0500, Scott D. Lancaster wrote: > I have a mediaone cable modem. It's sort of like having a direct > internet connection. > I have been fumbling around(and I'm too excited) trying to figure out > how to create a > floppy that would allow me to install freebsd in this fashion. A section > on this, up and > coming connectivity, would be nice. Can you also tell me how to go about > doing this? I can't speak for your specific situation, because I've never used a MediaOne cable modem. However, if it behaves like a regular ethernet connection then you shouldn't need to do anything too special, it should just work. Your best bet is probably to repost your question to the questions mailing list (questions@FreeBSD.org) and see if people can provide specific advice there. If you do get it working, and you had to do anything particularly out of the ordinary, we'd appreciate you popping back here and letting us know about it, so we can try and document it in the Handbook and/or FAQ. Even better would be if you could write the documentation. . . Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:43:20 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 39F6015133 for ; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25935; Tue, 24 Aug 1999 19:26:41 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA67389; Tue, 24 Aug 1999 16:20:11 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 16:20:11 +0100 From: Nik Clayton To: "Coelho, Joao@EDD" Cc: freebsd-doc@FreeBSD.org Subject: Re: Help out. Message-ID: <19990824162011.C65430@kilt.nothing-going-on.org> References: <9CF6ED1D2A5ED211BDCA00805FA783D1029E59F2@eddexmb05.cahwnet.gov> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <9CF6ED1D2A5ED211BDCA00805FA783D1029E59F2@eddexmb05.cahwnet.gov>; from Coelho, Joao@EDD on Tue, Aug 10, 1999 at 12:56:58PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Joao, Please excuse the amount of time it's taken for me to reply to this, things have been somewhat hectic on the -doc front recently. On Tue, Aug 10, 1999 at 12:56:58PM -0700, Coelho, Joao@EDD wrote: > While I virtually know nothing about BSD or Unix. I have worked with Xenix > on a programming assignment for a job, and at home with coherent now dead , > I figured that the best way to learn more is to do something like this. If > you think my inexperience is usable I am interested. Let me know. > My home email address is: jtcoelho@msn.com Thanks for getting in touch. Given that you say you're new to BSD and Unix, there's a vast number of ways in which you could be able to help. And they're all because of your inexperience. A lot of our documentation is (inevitably) written by people who have some mastery of the subject they're documenting. This means (and I'm as guilty of this as anyone) that sometimes the documentation manages to skip over steps that (to the author) are obvious, or omits information that the author thinks "everyone knows". You will undoubtedly find this as you use the available documentation to learn how to use FreeBSD. Probably the most valuable thing you can do when this happens is (a) ask questions about the problem you're finding on the appropriate mailing list (which will almost certainly be questions@FreeBSD.org) and then (b) take those answers, and submit corrections and clarifications to the documentation, based on what worked for you. The best way to submit changes and requests is using the send-pr(1) program which is installed with FreeBSD. Detailed instructions on how to actually do this can be found at http://www.FreeBSD.org/docproj/submitting.html. Welcome to the FreeBSD Documentation Project! I look forward to seeing your first changes and clarifications. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:44: 5 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 29046159BA; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25939; Tue, 24 Aug 1999 19:26:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA66251; Tue, 24 Aug 1999 16:10:59 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 16:10:59 +0100 From: Nik Clayton To: jhb@FreeBSD.org Cc: jobaldwi@vt.edu, freebsd-doc@FreeBSD.org Subject: Re: docs/12657: Handbook on ftp mirrors is old... Message-ID: <19990824161059.A65430@kilt.nothing-going-on.org> References: <199908240328.UAA36218@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908240328.UAA36218@freefall.freebsd.org>; from jhb@FreeBSD.org on Mon, Aug 23, 1999 at 08:28:12PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 08:28:12PM -0700, jhb@FreeBSD.org wrote: > Synopsis: Handbook on ftp mirrors is old... > > State-Changed-From-To: open->closed > State-Changed-By: jhb > State-Changed-When: Mon Aug 23 20:27:19 PDT 1999 > State-Changed-Why: > The new doc/ makefiles render this PR obsolete. Just for completenesses sake: they almost render this PR obsolete. There's a little bit of ongoing discussion about the best way to make the packages (whether in doc/ or in ports/) but I expect that to be resolved very shortly. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:44:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 43E5D159CA; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25944; Tue, 24 Aug 1999 19:26:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA73072; Tue, 24 Aug 1999 17:06:34 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:06:34 +0100 From: Nik Clayton To: Jonathan Kopka Cc: freebsd-newbies@freebsd.org, freebsd-doc@freebsd.org Subject: Re: Thanks for the FAQ Message-ID: <19990824170634.G65430@kilt.nothing-going-on.org> References: <000201bee9c0$7975aba0$c323f7a5@default> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <000201bee9c0$7975aba0$c323f7a5@default>; from Jonathan Kopka on Wed, Aug 18, 1999 at 05:26:52PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Jonathan, On Wed, Aug 18, 1999 at 05:26:52PM -0400, Jonathan Kopka wrote: > I wasn't sure who to write to to thank > for the information regarding using the > boot -v option and the BIOS cylinder > translation info along with the slice -> > fdisk -> "g" option. (FAQ sections 2.15 and > 8.10) Many thanks to the FreeBSD team > for that information, installed 3.2-RELEASE > today (got it right the second time around with > the "g" option). Since no one else has replied to this yet, I'd just like to say thanks, on behalf of the FreeBSD Documentation Project and the translation projects) for your comments. It's always nice to know that other people are using and profiting from the work and effort that's been put in to the FreeBSD Documentation Project. Cheers, Nik -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:44:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id B904515216; Tue, 24 Aug 1999 11:42:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25945; Tue, 24 Aug 1999 19:26:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA74091; Tue, 24 Aug 1999 17:14:44 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:14:44 +0100 From: Nik Clayton To: Neil Blakey-Milner Cc: Nik Clayton , doc@FreeBSD.org Subject: Re: Some proposed changes in expectation of obj'able doc makes Message-ID: <19990824171444.J65430@kilt.nothing-going-on.org> References: <19990823115900.A6290@rucus.ru.ac.za> <19990823140332.C2121@catkin.nothing-going-on.org> <19990823160116.A96603@rucus.ru.ac.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990823160116.A96603@rucus.ru.ac.za>; from Neil Blakey-Milner on Mon, Aug 23, 1999 at 04:01:17PM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 04:01:17PM +0200, Neil Blakey-Milner wrote: > I'll sgml-ify it later, but here's a synopsis: > > When you're using "make" to create a project, it is possible to have > the actual output created by the make process to go into a separate > parallel directory tree, so that you don't mess up or otherwise touch > the original tree. > In my example, DOC_PREFIX=../../.. doesn't help, since you can't use it > to find the actual doc prefix from .OBJDIR, since its ../../.. usually > points somewhere other than you expect. This is especially so if you're > doing "jade -d ${DOC_PREFIX}" or whatever, since it's working directory > is actually .OBJDIR, and you don't want a relative path. Excellent. Thanks for that, and yes, it all makes sense. I look forward to your patches. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:50:35 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 6994A159A5; Tue, 24 Aug 1999 11:49:53 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25948; Tue, 24 Aug 1999 19:26:43 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA75736; Tue, 24 Aug 1999 17:28:12 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:28:12 +0100 From: Nik Clayton To: Tim Vanderhoek Cc: Nik Clayton , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990824172812.L65430@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990823172005.C42397@ppp18344.on.bellglobal.com>; from Tim Vanderhoek on Mon, Aug 23, 1999 at 05:20:05PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 05:20:05PM -0400, Tim Vanderhoek wrote: > >> Would you [encourage|discourage] me from writing new hunks of > >> documentation that use DocBook with a formatting style such that each > >> new sentence begins on a new line? The idea here is that this would > >> make future diffs clearer and easier to read. This would directly > >> make synchronization of translations easier. I don't suppose anyone knows of a 'diff' that works on a per-sentence basis, rather than a per-line basis do they? If I'm understanding this right, the main benefit of this sort of change is when the English version goes from; This is the first sentence, less than one line. This is the second sentence, which will span several lines, in the course of its long, rambling nature. This is the third sentence, which can be as long, or short, as necessary. to This is the first sentence, less than one line. Second sentence is here, which will quite definitely span several lines, in the course of which it might ramble uncontrollably. This is the third sentence, which can be as long, or short, as necessary. If you do a diff of this, then obviously all four lines will be shown as changed, because they have. But to the translators, only the second sentence has changed, but they still have to read and compare the first and third sentences, because they appear in the diff(1) output. If we had a "sentence oriented" diff, it might be persuaded to blank out the first and third sentences, because although their position in the file has changed, their content has not. I'm not aware of any such diff, I spent a little bit of time on-line today trying to find one, but without much success. However, if we could find one (or persuade someone with the appropriate skills to write one, possibly even as a post-processor to diff(1)'s output) we could apply it to all the existing documentation, not just the new documentation written by Tim. [ Note: Please don't interpret this as an objection to Tim's idea. I just want to see if there's another way of tackling this problem that we haven't thought of yet. ] N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:52: 0 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id A0C3715A14; Tue, 24 Aug 1999 11:49:53 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA25949; Tue, 24 Aug 1999 19:26:43 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA74692; Tue, 24 Aug 1999 17:19:37 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 24 Aug 1999 17:19:37 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: Tim Vanderhoek , Nik Clayton , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990824171937.K65430@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Tue, Aug 24, 1999 at 03:05:10AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 03:05:10AM -0700, Satoshi - Ports Wraith - Asami wrote: > * > I can see how it makes the translations easier. I can also see how it > * > makes editing the content after it's been written more complicated (no more > * > M-q to refill the paragraph -- aargh). > > Refilling the paragraph after minor editing is a real pain for > translators. Yep. This is why standard operating procedure when working on stuff in doc/en* is to commit the content changes first, without making any white space changes (see, for example, my recent commits to handbook/ports/chapter.sgml) and then commit the whitespace, formatting changes separately). About the only exception to this is if the changes can be carried out completely mechanically, and the mechanism to do so is clearly described in the commit message (or supporting e-mail / README file, or equivalent). We're not perfect, and I've made a few mistakes in doing this myself, particularly in the early stages of the Handbook's DocBook migration. But I try and keep a whether eye out on the doc/en* commits, and do let people know if they've unwittingly made life harder for the translation teams. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:52: 1 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 49B1815A66 for ; Tue, 24 Aug 1999 11:51:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA15551; Tue, 24 Aug 1999 11:50:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Tue, 24 Aug 1999 11:50:04 -0700 (PDT) Message-Id: <199908241850.LAA15551@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Nik Clayton Subject: Re: docs/13345: obj-related DOC_PREFIX? changes Reply-To: Nik Clayton Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13345; it has been noted by GNATS. From: Nik Clayton To: nbm@rucus.ru.ac.za Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/13345: obj-related DOC_PREFIX? changes Date: Tue, 24 Aug 1999 17:34:38 +0100 On Tue, Aug 24, 1999 at 08:41:01AM -0000, nbm@rucus.ru.ac.za wrote: > >Description: > > These are pretty arbitrary preliminary changes to make obj'able doc > builds possible. The real stuff depends on this. It applies to all > languages. These certainly look OK, but I haven't got sufficient make(1) expertise to verify that they're doing the right thing. Could someone who does, (Satoshi? You expressed a strong interest in this) try these, and either commit them (if you're a committer) or let me know if they do they right thing, and I'll commit them. > It doesn't cover the tutorials, as they're governed by > web.mk (and that's a whole other story) doc/en*/tutorials/ is a hangover that will be vanishing soon. A couple of the entries in there still have to be migrated in to the articles/ or books/ directory, and then the tutorials directory will vanish as well. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 11:52:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id AC1E215B4D; Tue, 24 Aug 1999 11:52:20 -0700 (PDT) (envelope-from nik@FreeBSD.org) Received: (from nik@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA15750; Tue, 24 Aug 1999 11:52:18 -0700 (PDT) (envelope-from nik@FreeBSD.org) Date: Tue, 24 Aug 1999 11:52:18 -0700 (PDT) From: Message-Id: <199908241852.LAA15750@freefall.freebsd.org> To: nik@FreeBSD.org, freebsd-doc@FreeBSD.org, nik@FreeBSD.org Subject: Re: docs/13349: fix xref to ANCHOR in English FAQ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: fix xref to ANCHOR in English FAQ Responsible-Changed-From-To: freebsd-doc->nik Responsible-Changed-By: nik Responsible-Changed-When: Tue Aug 24 11:51:28 PDT 1999 Responsible-Changed-Why: Grabbed it. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 12:16:27 1999 Delivered-To: freebsd-doc@freebsd.org Received: from revolution.3-cities.com (revolution.3-cities.com [204.203.224.155]) by hub.freebsd.org (Postfix) with ESMTP id 0F162151DC; Tue, 24 Aug 1999 12:16:19 -0700 (PDT) (envelope-from kstewart@3-cities.com) Received: from 3-cities.com (kenn1237.bossig.com [208.26.241.237]) by revolution.3-cities.com (8.9.3/8.9.3) with ESMTP id MAA13817; Tue, 24 Aug 1999 12:15:02 -0700 (PDT) Message-ID: <37C2EF8C.6AB910E0@3-cities.com> Date: Tue, 24 Aug 1999 12:16:28 -0700 From: Kent Stewart Organization: Columbia Basin Virtual Community Project X-Mailer: Mozilla 4.61 [en] (WinNT; U) X-Accept-Language: en MIME-Version: 1.0 To: Gary Kline Cc: Peter McGarvey , Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG Subject: Re: FreeBSD webdesign References: <199908241123.HAA59303@lakes.dignus.com> <19990824101738.B2875@athena.tera.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Gary Kline wrote: > > On Tue, Aug 24, 1999 at 04:04:05PM +0100, Peter McGarvey wrote: > > Web styles/colour schemes are something I feel strongly about. > > > > I'm dyslexic. A bad colour scheme make my life hell. > > > > Personally I find Black on White difficult to read. When I'm trying > > to read along a line my eyes sort of "fall off". To get around this I > > have to peer at the sceen intently and usually end up getting a headache. > > > > Black on Light Grey is much nicer. > > > > Blue on Black is 100% impossible to read. > > > > Bigger bolder fonts help. > > > > However, instead of arguing the toss about personal preferance in colour, > > why not investigate a method of allowing users to overide colours and font > > styles. Much more user friendly. > > > > > > Hm, very interesting. This (black on light grey) may be > why so many commercial apps use this scheme. > > I prefer off-white for the bg and black (bold) fonts, but > this may not work for everyone, obviously. Do you know > how light the grey can be before you find it hard to read? > > I've played around with black on grey85 and it's fairly > reasonable. I've also experiments with bright > green|orange|blue typefaces on black... uhh, no. I have a tendancy to like bright white on dark blue but it depends on the font. When the font is terrible, I go for black on white. I can read it down to about 4 point type on a 19" monitor. Combinations of dark red or green on black kills me. The fact that these phosphour's are every third one, probably has something to do with it, i.e., a real lack of definition. I can read it if I jump the monitor back to 640 x 480 from 1152 x 854 or 1600 x 1280 but then I am running *Window* because I can only have one window on the screen at a time. > > Has anybody on the list found any websites with presentation > information? The only one I know of is http://webknowhow.net/dir/Design/Miscellaneous/. There site has much more. It is mostly links to somewhere else. Helen Triantafillou has a site at http://users.hol.gr/~andreas/hexcolor.htm that lists many combinations of colors and their hex values. Kent > > gary > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-questions" in the body of the message -- Kent Stewart Richland, WA mailto:kstewart@3-cities.com http://www.3-cities.com/~kstewart/index.html Hunting Archibald Stewart, b 1802 in Ballymena, Antrim Co., NIR http://www.3-cities.com/~kstewart/genealogy/archibald_stewart.html To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 12:32:55 1999 Delivered-To: freebsd-doc@freebsd.org Received: from haldjas.folklore.ee (Haldjas.folklore.ee [193.40.6.121]) by hub.freebsd.org (Postfix) with ESMTP id 22CC9150E1 for ; Tue, 24 Aug 1999 12:32:40 -0700 (PDT) (envelope-from narvi@haldjas.folklore.ee) Received: from haldjas.folklore.ee (haldjas.folklore.ee [172.17.2.1] (may be forged)) by haldjas.folklore.ee (8.8.8/8.8.4) with SMTP id WAA09238 for ; Tue, 24 Aug 1999 22:31:12 +0300 (EEST) Date: Tue, 24 Aug 1999 22:31:11 +0300 (EEST) From: Narvi To: freebsd-doc@freebsd.org Subject: Addition to docbook primer Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Below is a patch that might be (or might not be) a worthwhile addition to the doc-book primer. If needed, I can resubmit it via send-pr. ---- cut here ---------------- *** chapter.sgml Tue Aug 24 22:25:45 1999 --- chapter.sgml Tue Aug 24 22:25:26 1999 *************** *** 1610,1615 **** --- 1611,1624 ---- directory. You should also see a Makefile and a number of files with a .ent extension.]]> + + The filename element has the class attribute + that can be used to indicate the type of the file. Possible values + for the class attribute are + headerfile + symlink + directory + . Appearance: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 13:52:11 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gershwin.tera.com (gershwin.tera.com [207.224.230.28]) by hub.freebsd.org (Postfix) with ESMTP id 4832C15158; Tue, 24 Aug 1999 13:52:01 -0700 (PDT) (envelope-from kline@tera.com) Received: from athena.tera.com (athena.tera.com [207.224.230.169]) by gershwin.tera.com (8.8.8/8.8.8) with ESMTP id NAA22055; Tue, 24 Aug 1999 13:49:25 -0700 (PDT) From: Gary Kline Received: (from kline@localhost) by athena.tera.com (8.7.5/8.7.3) id NAA05311; Tue, 24 Aug 1999 13:49:24 -0700 (PDT) Message-Id: <199908242049.NAA05311@athena.tera.com> Subject: Re: FreeBSD webdesign In-Reply-To: <37C2EF8C.6AB910E0@3-cities.com> from Kent Stewart at "Aug 24, 99 12:16:28 pm" To: kstewart@3-cities.com (Kent Stewart) Date: Tue, 24 Aug 1999 13:49:24 -0700 (PDT) Cc: kline@tera.com, Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG X-Mailer: ELM [version 2.4ME+ PL23 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org According to Kent Stewart: > > > Gary Kline wrote: > > > > I've played around with black on grey85 and it's fairly > > reasonable. I've also experiments with bright > > green|orange|blue typefaces on black... uhh, no. > > I have a tendancy to like bright white on dark blue but it depends on > the font. When the font is terrible, I go for black on white. I can > read it down to about 4 point type on a 19" monitor. Combinations of > dark red or green on black kills me. The fact that these phosphour's > are every third one, probably has something to do with it, i.e., a > real lack of definition. I can read it if I jump the monitor back to > 640 x 480 from 1152 x 854 or 1600 x 1280 but then I am running > *Window* because I can only have one window on the screen at a time. > I've come across some of the "micro-print" sites. On my 17" 1280x1024 tube at home, it's painful to read, whatever color the fg/bg. > > > > Has anybody on the list found any websites with presentation > > information? > > The only one I know of is > http://webknowhow.net/dir/Design/Miscellaneous/. There site has much > more. It is mostly links to somewhere else. Helen Triantafillou has a > site at http://users.hol.gr/~andreas/hexcolor.htm that lists many > combinations of colors and their hex values. > Noted and saved away, thanks much. I asked one of our GUI wizards and he suggested doing what Netscape and other commercial apps did. So I'm following that way pretty much. I did search around for awhile; didn't find your design sites, tho. Black on grey may be the best compromise, but it leaves me cold! gary To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 15:19:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 61BF0151DD; Tue, 24 Aug 1999 15:19:14 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18415.on.bellglobal.com (ppp18373.on.bellglobal.com [206.172.130.53]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id SAA15539; Tue, 24 Aug 1999 18:21:01 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id SAA09139; Tue, 24 Aug 1999 18:21:37 -0400 (EDT) (envelope-from tim) Date: Tue, 24 Aug 1999 18:21:37 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: Satoshi - Ports Wraith - Asami , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990824182137.B8869@ppp18415.on.bellglobal.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824171937.K65430@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990824171937.K65430@kilt.nothing-going-on.org>; from Nik Clayton on Tue, Aug 24, 1999 at 05:19:37PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 05:19:37PM +0100, Nik Clayton wrote: > > Yep. This is why standard operating procedure when working on stuff in > doc/en* is to commit the content changes first, without making any white FWIW, part of what prompted my request ("suggestion"?) was that the above mode of operation produces really ugly interm docs that are hard to read (and thus hard to write). -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 16: 6:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 806B314DE6 for ; Tue, 24 Aug 1999 16:06:08 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA38497; Tue, 24 Aug 1999 21:00:22 +0100 (BST) (envelope-from nik) Date: Tue, 24 Aug 1999 21:00:22 +0100 From: Nik Clayton To: Narvi Cc: freebsd-doc@freebsd.org Subject: Re: Addition to docbook primer Message-ID: <19990824210022.A28710@catkin.nothing-going-on.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Narvi on Tue, Aug 24, 1999 at 10:31:11PM +0300 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 10:31:11PM +0300, Narvi wrote: > > Below is a patch that might be (or might not be) a worthwhile addition to > the doc-book primer. If needed, I can resubmit it via send-pr. > > ---- cut here ---------------- > *** chapter.sgml Tue Aug 24 22:25:45 1999 > --- chapter.sgml Tue Aug 24 22:25:26 1999 > *************** > *** 1610,1615 **** > --- 1611,1624 ---- > directory. You should also see a Makefile > and a number of files with a .ent > extension.]]> > + > + The filename element has the class attribute > + that can be used to indicate the type of the file. Possible values > + for the class attribute are > + headerfile > + symlink > + directory > + . > > Appearance: Ye-es. I'd refrained from documenting this, because I figured it was starting to get in to the realm of markup for markup's sake, rather than because the information was going to be useful. But, that's just my opinion. If anyone thinks that marking up to this level is useful (or is sufficiently likely to be useful) to be worthwhile then say so, and I'll apply that patch. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 16:14:48 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 94E5F158A5; Tue, 24 Aug 1999 16:14:39 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id AAA62562; Wed, 25 Aug 1999 00:14:06 +0100 (BST) (envelope-from nik) Date: Wed, 25 Aug 1999 00:14:06 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990825001406.A62322@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 02:43:33AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Satoshi, On Sun, Aug 22, 1999 at 02:43:33AM -0700, Satoshi - Ports Wraith - Asami wrote: > There's another one. You converted the documents from Linuxdoc to > Docbook, arguing it's better. Honestly, I still don't see why it was > necessary. The few documents I care about (handbook's ports chapter) > is much harder to read in HTML after the conversion with all the > numbers gone from the section headers. Please can you look at and let me know if that's the sort of format you want to see. If you need any tweaks we should be able to accomodate them. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 17:11:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 66CDC152BC; Tue, 24 Aug 1999 17:11:17 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18415.on.bellglobal.com (ppp18335.on.bellglobal.com [206.172.130.15]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id UAA21938; Tue, 24 Aug 1999 20:10:40 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id TAA09974; Tue, 24 Aug 1999 19:50:38 -0400 (EDT) (envelope-from tim) Date: Tue, 24 Aug 1999 19:50:38 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990824195038.D8869@ppp18415.on.bellglobal.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990824172812.L65430@kilt.nothing-going-on.org>; from Nik Clayton on Tue, Aug 24, 1999 at 05:28:12PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 05:28:12PM +0100, Nik Clayton wrote: > > If we had a "sentence oriented" diff, it might be persuaded to blank out > the first and third sentences, because although their position in the file > has changed, their content has not. As a hack, you could do perl -pe 's/\<[^>]+\>//g; s/[\n\t ]+/ /g; s/[!?,.]/$&\n/g; ' | perl -pe 's/\s{2,}/ /g' < Englishfile1 > a perl -pe 's/\<[^>]+\>//g; s/[\n\t ]+/ /g; s/[!?,.]/$&\n/g; ' | perl -pe 's/\s{2,}/ /g' < Englishfile2 > b diff [-uc] a b That actually seems to work reasonably well for some changes. For other changes, it can make the diffs more confusing. [Don't mind the perl regexp --- perl and I weren't getting along today...] -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 17:50: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mailgw.cablecom.ne.jp (mailgw.cablecom.ne.jp [202.248.199.37]) by hub.freebsd.org (Postfix) with ESMTP id 11E0B15103; Tue, 24 Aug 1999 17:49:58 -0700 (PDT) (envelope-from motoyuki@snipe.rim.or.jp) Received: from srv2.cablecom.ne.jp by mailgw.cablecom.ne.jp (8.8.8/3.7W) id JAA21499; Wed, 25 Aug 1999 09:49:38 +0900 (JST) Received: from mail.snipe.rim.or.jp by srv2.cablecom.ne.jp (8.8.8/3.7W) id JAA01491; Wed, 25 Aug 1999 09:49:37 +0900 (JST) Received: from rei.snipe.rim.or.jp (rei.snipe.rim.or.jp [192.168.11.11]) by mail.snipe.rim.or.jp (8.9.3/3.7W) with ESMTP id JAA26943; Wed, 25 Aug 1999 09:49:35 +0900 (JST) Received: from rei.snipe.rim.or.jp (localhost.snipe.rim.or.jp [127.0.0.1]) by rei.snipe.rim.or.jp (8.9.3/3.7W) with ESMTP id JAA00382; Wed, 25 Aug 1999 09:49:35 +0900 (JST) Message-Id: <199908250049.JAA00382@rei.snipe.rim.or.jp> To: Nik Clayton Cc: Tim Vanderhoek , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? X-Mailer: mh-e on Mule 2.3 / Emacs 19.34.1 References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> Mime-Version: 1.0 (generated by tm-edit 7.106) Content-Type: text/plain; charset=US-ASCII Date: Wed, 25 Aug 1999 09:49:35 +0900 From: Motoyuki Konno Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik, Nik Clayton wrote: > If I'm understanding this right, the main benefit of this sort of change > is when the English version goes from; > > This is the first sentence, less than one line. This is the > second sentence, which will span several lines, in the course of > its long, rambling nature. This is the third sentence, which > can be as long, or short, as necessary. > > to > > This is the first sentence, less than one line. Second > sentence is here, which will quite definitely span several lines, in > the course of which it might ramble uncontrollably. This is the > third sentence, which can be as long, or short, as necessary. [snip] > I'm not aware of any such diff, I spent a little bit of time on-line today > trying to find one, but without much success. However, if we could find > one (or persuade someone with the appropriate skills to write one, possibly > even as a post-processor to diff(1)'s output) we could apply it to all the > existing documentation, not just the new documentation written by Tim. When FreeBSD handbook was converted to DocBook, there were so many changes like this. Japanese doc team used GNU wdiff (see ports/textproc/wdiff) to find out the real changes, but it is inconvinient.... *IF* we must refill or reformat the paragraphs of the English version, the following steps will help the translator teams. 1. Announce to the -doc list. The translated version (Japanese, Chinese, etc.) is not synced with the English version very often. So, tranlation teams need time to work. In some cases, they need two or three weeks or more. For example, most of Japanese doc team members are very busy in January, February and March. Some of them must prepare for the examination of their university or highschool, and some of them must work hard in their office. 2. Make sure that all tranlated version are synched with the English version. 3. Refill or rewrite the English version. No *real* change please. Insert/delete whitespaces and newlines only. 4. Commit the changes in the step 3. -- ------------------------------------------------------------------------ Motoyuki Konno mkonno@res.yamanashi-med.ac.jp (Univ) motoyuki@snipe.rim.or.jp (Home) motoyuki@FreeBSD.ORG (FreeBSD Project) Yamanashi Medical University http://www.freebsd.org/~motoyuki/ (WWW) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 18:34:26 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nisser.com (n2000039.telekabel.chello.nl [212.187.0.39]) by hub.freebsd.org (Postfix) with ESMTP id 61593151AB; Tue, 24 Aug 1999 18:34:15 -0700 (PDT) (envelope-from roelof@nisser.com) Received: from nisser.com (roelof [10.0.0.2]) by nisser.com (8.9.3/8.9.2) with ESMTP id DAA60817; Wed, 25 Aug 1999 03:33:07 +0200 (CEST) (envelope-from roelof@nisser.com) Message-ID: <37C347CE.A49ED05C@nisser.com> Date: Wed, 25 Aug 1999 03:33:02 +0200 From: Roelof Osinga Organization: eboa - engineering buro Office Automation X-Mailer: Mozilla 4.6 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: Gary Kline Cc: Kent Stewart , Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, freebsd-doc@FreeBSD.ORG, freebsd-questions@FreeBSD.ORG Subject: Re: FreeBSD webdesign References: <199908242049.NAA05311@athena.tera.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Gary Kline wrote: > > According to Kent Stewart: > > > > > > Gary Kline wrote: > > > > > > ... > > > Has anybody on the list found any websites with presentation > > > information? > > > > The only one I know of is > > http://webknowhow.net/dir/Design/Miscellaneous/. There site has much > > more. It is mostly links to somewhere else. Helen Triantafillou has a > > site at http://users.hol.gr/~andreas/hexcolor.htm that lists many > > combinations of colors and their hex values. > > > > Noted and saved away, thanks much. If that holds your interest you might want to take a look at the Kolere! Applet. Something I wrote whilest test JBuilder 1 and needed to toy with colorschemes and their effect on various monitors. You can find it at http://eboa.com/Java/KolereApplet.html > I asked one of our GUI wizards and he suggested doing what Netscape > and other commercial apps did. Wise advise, though I would change that to looking at commercial sites since we're talking about websites. Roelof -- Home is where the (@) http://eboa.com/ is. Telekabel home http://nisser.com/ My home http://osinga.org/ Wife's home http://wentwading.com/ Dog's home http://cairni.com/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Aug 24 20: 2:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id C723614E18 for ; Tue, 24 Aug 1999 20:02:25 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id UAA59975; Tue, 24 Aug 1999 20:00:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from icc.surw.chel.su (surw.chel.su [195.54.2.162]) by hub.freebsd.org (Postfix) with ESMTP id DA0A314BF2 for ; Tue, 24 Aug 1999 19:58:51 -0700 (PDT) (envelope-from andy@icc.surw.chel.su) Received: (from andy@localhost) by icc.surw.chel.su (8.9.2/8.8.8) id GAA63449; Wed, 25 Aug 1999 06:58:39 +0400 (MSD) (envelope-from andy) Message-Id: <199908250258.GAA63449@icc.surw.chel.su> Date: Wed, 25 Aug 1999 06:58:39 +0400 (MSD) From: Andrey Zakhvatov Reply-To: andy@icc.surw.chel.su To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13366: Update doc: doc/ru/FAQ/applications.sgml Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13366 >Category: docs >Synopsis: Update doc: doc/ru/FAQ/applications.sgml >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Aug 24 20:00:02 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Andrey Zakhvatov >Release: FreeBSD 3.1-RELEASE i386 >Organization: South Ural Railway ICC >Environment: >Description: This is a patch to sync doc/ru/FAQ/applications.sgml with English 1.14. It's a last commit of series in syncing with English FAQ _before_ switching to DocBook format. After committing this patch we can switch to DocBook. begin 644 applications.diff.gz M'XL(".I9PS<``V%P<&QI8V%T:6]N_DBVG%=.[,!V2)Y^=SS\ISGGN-L-@MDL[&E$J6^]C6I M5[8UF?\B:XT*:77^O/*%_-GG#^:S*^3CI3\2I=FL52M*N]JH:[*VL57[S9-. M'3[%3[X(A=QBOKB8GX'\PL+"5":3.0\<85Z"M-39`,A#;FYQ9FZQF`N1[MV# M;%ZZ`QG^Z]Z]J6SI/33Z_0=KB_`6BK0->?F.>(_D9@E:E9^-K*I7G\'RBR:\ M#]EL>2KS:R"1'R0W3W)H43&RB#N3@@$!\W13A8];JOK1D_NPTM&TJE*'^XU* M9TNMMP4N/&XUOE(K[?"=*0`H:7A9%KX5YZ1\`3+\SQSW3SSG/Z4U5:NTJLUR M?`-OM96-LF$/H"`7Y/EL2ZVIBJ:2\$IK*ZLUM43XFJEL\DJG50/\_'9ZO=U< M)`1_RY&Q\N;"G,*,"G8$IF4<'*O639M M$SSHVN:^WCNB>PPL&.D.'-*AI=L'+L,['AV.Z%"7A4+,Y*1YR,S,2`M"'Q*< M'QS:\RF,8&0:@00G/@,7+ST*?3;TQ^"PO<"'[M@_`(-Y?M!WQ^%B&H/T=4LW M]FE/`E^WP,)/'Q>R@>LR,(T=']_KZB.;NB8%EXW&KV3XB?9M]HK!:$B=`3`_ MAN+7N`[Z0X:6#_P#B>/A>^$>YL0$5P?F(9K+G,A/&G/DHJRN8]!7M;6WDI`0 M*\E:>NET68[S>AVJ)&28@*:6)J`EPO4[GZ2U%%]&.VZJREJUOE'^FX%QTWN^ M"5T3\\U\:@50JZY69*TA(Z7OEDB\-,ST@C0+F=D9:>YLID\QXOLT3/%H#/VQ MKU.?>@=PJ/<#SS$*QL'NP8QS,]'W,$&'#/-'%57GXAPRG; MU^V@Y_FZQ'-W@F"8LR$UQD9P;/9@J!\:U`8S1D%W#+&$&:^8,>!+^)XC_8CV MHBW&@G_`:1Y:=D;CT]),/ M:HWGJTKKP^6'7_QAZ>DR>1?3A=&9A=S9+$XRG7;F=$CW#5&T6/430YF/&=`M MW\1JXD9^H_=L;F.9J.T*T;[6*HWZ>G4#!;N=Z/4M'O#29GNKEA!^LRT8__SY M\S-E5-FHDBVE+N/?NZV*S+%NS=Q.N'\Y4+IT?@GHC)X*DZ.GT^7;$IB'7"E0 MB7C.;&JXU(EH1N'0U4^$W/`'P>XQ[25:187"N*S'20U9]NZ)Z6/Y[`V#0ZQ)AQD!LAA);=#AOI5R/X[N5>.) MQ:T5IB/7PXODV+IJ*"_$2.H/7OMZG\:VFW'1R6>\?*/CO12API@CDRS=UVVV M!Z32V&HJ;2+@\9S:YE4C%*8[!N:&;7=N7LKG,:SY6=ZCGJO#?^I=YNMXDFF- MRC.D))XTMBX2B/K`SS$(4%".*5KFBDB7E\R\X6B5.`%7"Q(,^D*YAF_2(4J54UN;%8;O+EMJ[*ZUB%_0<-: MY,&C1S*GR#D1\GSDF7F"I?[=Z]Y(A[^^'@[UZ3+8`#[55\C@@[<3QNC'_4+=Q0\'\7 M'E8KK8;66&_C2-FHMQ]C7\/N.W-G+-5\DN(]K-AKUDLF&,--DWO6/H$Z23!F]E[7S&3D,HSL5\.]T&?YSN&HG&U]%@8R3\LM4/V4G%.7, MI1;SV7`TXPH MRIO..)UA>RV=.0@9BH7.FQD^,$4PL=R+/CG:5TK).;;.R!/6Q4F)#V`#G*B*X3;]*`P9 M&O?O<'9-8H'UA&G1]W2>[W!HLIAM4^NE.8CEB8L>,B'$$VV1Q6=CZEOT?()" M$\WP\2B5*^YI/ST^L2-Q>N+YT#T632SKQF"O?=0?=F1V+2JTT&''![N&2FLA<7@B36;.VAN/EW4NIRUE&61?A+G']PZ.F&14HZ6HO@H*R^ M4"M$^(,O3HQ+IFE$BY'2-LKP#]<,NWPJ_NEA8&LR-+N!CV,'MR5L?@N%1/#> M1"&@0#"]]34^8U7K^+56$P4:?9>U31C%/31-8**^.09#)!W+E@<4'?.%`#%D MO8]D/8UG;`S,/D4>6@%6A#^&Y965I:=+*8&(X\7_V;C")?(".L02^3^W*3`6 $R!<``(UG ` end >How-To-Repeat: >Fix: Please, check and commit this patch. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 0:36:44 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 809B9158E1 for ; Wed, 25 Aug 1999 00:36:05 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 11018 invoked by uid 1003); 25 Aug 1999 07:36:57 -0000 Date: Wed, 25 Aug 1999 09:36:57 +0200 From: Neil Blakey-Milner To: jkoshy@FreeBSD.ORG Cc: freebsd-doc@FreeBSD.ORG Subject: Re: New FAQ entry Message-ID: <19990825093657.A9956@rucus.ru.ac.za> References: <199908240911.CAA76582@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <199908240911.CAA76582@freefall.freebsd.org>; from jkoshy@FreeBSD.ORG on Tue, Aug 24, 1999 at 02:11:51AM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue 1999-08-24 (02:11), jkoshy@FreeBSD.ORG wrote: > Comments solicited on the following FAQ entry: > > ---------------------------------------------------------------- > Q: Can ordinary users mount floppies and other removable media? > > A: Yes, they can, but this feature is not enabled by default in FreeBSD. > Here is how to allow non-root users to mount devices: Me again - I submitted a patch to the rc system which allowed for the setting of vfs.usermount based on a variable which defaults to NO in defaults/rc.conf. If that gets in, we should mention it. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 4:20:57 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix10.ix.netcom.com (dfw-ix10.ix.netcom.com [206.214.98.10]) by hub.freebsd.org (Postfix) with ESMTP id 7B19815099; Wed, 25 Aug 1999 04:20:55 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix10.ix.netcom.com (8.8.4/8.8.4) id GAA06254; Wed, 25 Aug 1999 06:20:52 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix10.ix.netcom.com via smap (V1.3) id rma006250; Wed Aug 25 06:20:32 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id EAA18598; Wed, 25 Aug 1999 04:20:27 -0700 (PDT) To: Nik Clayton Cc: Tim Vanderhoek , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824171937.K65430@kilt.nothing-going-on.org> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 25 Aug 1999 04:20:27 -0700 In-Reply-To: Nik Clayton's message of "Tue, 24 Aug 1999 17:19:37 +0100" Message-ID: Lines: 20 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Nik Clayton * About the only exception to this is if the changes can be carried out * completely mechanically, and the mechanism to do so is clearly described * in the commit message (or supporting e-mail / README file, or equivalent). The problem is that you can't separate the real change with formatting change with diff. Whether the formatting part can be done mechanically or not has nothing to do with this (unless there's a way to mechanically convert back to the original formatting/content change applied state). * We're not perfect, and I've made a few mistakes in doing this myself, * particularly in the early stages of the Handbook's DocBook migration. But * I try and keep a whether eye out on the doc/en* commits, and do let people * know if they've unwittingly made life harder for the translation teams. Amen. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 8:38: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mail.kt.rim.or.jp (mail.kt.rim.or.jp [202.247.130.53]) by hub.freebsd.org (Postfix) with ESMTP id ABA0F15187 for ; Wed, 25 Aug 1999 08:38:01 -0700 (PDT) (envelope-from kuriyama@sky.rim.or.jp) Received: from rhea.sky.rim.or.jp (ppp390.kt.rim.or.jp [202.247.140.90]) by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id AAA20241 for ; Thu, 26 Aug 1999 00:36:39 +0900 (JST) Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1]) by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id AAA92586 for ; Thu, 26 Aug 1999 00:36:35 +0900 (JST) Date: Thu, 26 Aug 1999 00:36:35 +0900 Message-ID: <14276.3459.55262.13042Y@localhost.sky.rim.or.jp> From: Jun Kuriyama To: doc@freebsd.org Subject: Re: docproj.docbook.mk cruft, naming, splitting In-Reply-To: In your message of "Thu, 19 Aug 1999 14:19:16 +0100" <19990819141916.A36423@kilt.nothing-going-on.org> References: <19990819141916.A36423@kilt.nothing-going-on.org> User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org From: Nik Clayton > doc/share/mk/fdp.own.mk > fdp.docbook.mk > fdp.install.mk > fdp.subdir.mk I don't like a word "fdp". I think many users who is not interested in Documentation Project cannot understand objectives of these files. I'd like to name them simply like this: doc/share/mk/doc.own.mk doc.docbook.mk doc.install.mk doc.subdir.mk Jun Kuriyama // kuriyama@FreeBSD.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 11:33: 2 1999 Delivered-To: freebsd-doc@freebsd.org Received: from imo22.mx.aol.com (imo22.mx.aol.com [198.81.17.66]) by hub.freebsd.org (Postfix) with ESMTP id 7F4A4152FF for ; Wed, 25 Aug 1999 11:32:59 -0700 (PDT) (envelope-from AlmostFree@aol.com) Received: from AlmostFree@aol.com by imo22.mx.aol.com (mail_out_v22.4.) id nMWYa06597 (4570) for ; Wed, 25 Aug 1999 14:32:21 -0400 (EDT) From: AlmostFree@aol.com Message-ID: Date: Wed, 25 Aug 1999 14:32:20 EDT Subject: Handbook question on the WWW To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: AOL 4.0 for Windows 95 sub 21 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org What did you use to submit your sites to AOL? I was curious because when I typed in "handbook," your sites came up as half of the hits on the first several pages. I was actually looking for a driver's handbook for my wife, but was impressed by the number of references FreeBSD had. Can you give me any tips on how to get this kind of ranking on AOL Netfinder as you did? I just started my company and can use all the help I can get. Thank you, Frank Diaz www.wholesalecalls.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 11:48:59 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 87F2215A5B; Wed, 25 Aug 1999 11:48:24 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA04555; Wed, 25 Aug 1999 19:37:45 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id RAA40452; Wed, 25 Aug 1999 17:26:44 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 17:26:44 +0100 From: Nik Clayton To: Nik Clayton Cc: doc@freebsd.org Subject: Re: ToDo Message-ID: <19990825172643.A39933@kilt.nothing-going-on.org> References: <19990824180638.A78397@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990824180638.A78397@kilt.nothing-going-on.org>; from Nik Clayton on Tue, Aug 24, 1999 at 06:06:38PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 06:06:38PM +0100, Nik Clayton wrote: > I thought various people might like to see my current ToDo list for > the doc/ tree over the next 30 days or so. Partly to get an idea of > what's coming up (or might be coming up, assuming it's not contentious) > and partly so that interested parties can stick their hands in the air > and say that they'd like to do it. Most of the stuff is fairly routine, > but if anyone wants to get their hands dirty they're more than welcome > to take on one or more of these tasks. There's more, there's always more. And if anyone has a list of things they'd like done, please add to this thread. I'll take the entries, and add them to "Current tasks" page on the website and/or enter them as PRs, so we can track them. * docproj.docbook.mk needs to die. Or, more accurately, it needs to be split up into smaller files, somewhat along the lines of /usr/share/mk, (fdp.subdir.mk, fdp.own.mk, fdp.docbook.mk, fdp.install.mk, and so on). The make(1) framework needs to be described in the Primer. * The make(1) framework needs to be made OBJDIR compatible. I didn't know this until a couple of days ago ( :-) ), and it looks like we have people working on this already, which is great. * The Handbook has a bibliography section. The DocBook bibliography markup should be used in that section. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 11:49:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id B161415180; Wed, 25 Aug 1999 11:48:24 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA04561; Wed, 25 Aug 1999 19:37:46 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id LAA99870; Wed, 25 Aug 1999 11:55:10 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 11:55:10 +0100 From: Nik Clayton To: Motoyuki Konno Cc: Nik Clayton , Tim Vanderhoek , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990825115510.A96398@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908250049.JAA00382@rei.snipe.rim.or.jp>; from Motoyuki Konno on Wed, Aug 25, 1999 at 09:49:35AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Motoyuki, On Wed, Aug 25, 1999 at 09:49:35AM +0900, Motoyuki Konno wrote: > > I'm not aware of any such diff, I spent a little bit of time on-line today > > trying to find one, but without much success. However, if we could find > > one (or persuade someone with the appropriate skills to write one, possibly > > even as a post-processor to diff(1)'s output) we could apply it to all the > > existing documentation, not just the new documentation written by Tim. > > When FreeBSD handbook was converted to DocBook, there were so many > changes like this. There were? I know I made a few at the beginning, and Jun quickly told me where I wasn't being careful enough, but after the first few (and there were something like 60 or so different commits as part of the conversion) I thought I'd made sure that all the commits were content only. There was one huge white-space commit at the end of the conversion, but that was clearly flagged as such in the commit message, so that the translation teams could ignore it. > Japanese doc team used GNU wdiff (see ports/textproc/wdiff) to find > out the real changes, but it is inconvinient.... I'll experiment with wdiff later. Thanks for the pointer. > *IF* we must refill or reformat the paragraphs of the English version, I think we must. There are two reasons for this; 1. It makes the file easier to follow. If the file is easier to follow then it makes it easier to add new documentation, see the structure of the document, and so on. 2. (Related to 1) It lets the documentation serve as a good example of DocBook to others. I get several messages a week (which I might start forwarding on to -doc just for information) praising the FreeBSD Handbook from people who are starting to learn DocBook, and who have used the FreeBSD Handbook as a model of good markup and structure. > the following steps will help the translator teams. > > 1. Announce to the -doc list. > The translated version (Japanese, Chinese, etc.) is not synced > with the English version very often. So, tranlation teams need > time to work. In some cases, they need two or three weeks or more. > For example, most of Japanese doc team members are very busy > in January, February and March. Some of them must prepare for > the examination of their university or highschool, and some of > them must work hard in their office. > > 2. Make sure that all tranlated version are synched with the English > version. > > 3. Refill or rewrite the English version. > No *real* change please. Insert/delete whitespaces and newlines > only. > > 4. Commit the changes in the step 3. One of us is missing something here, I think, and I'm not sure who. Suppose you have foo.sgml, at version 1.1, in both English and Japanese. Now suppose that someone comes along, and makes some content changes to the English version of foo.sgml. The commit trail looks something like; 1.2 Add a new sentence in the middle of a paragraph. No white space change, so the new sentence runs over column 76, and the formatting is generally ugly. 1.3 White space changes only, so that it looks better. 1.4 Adding a completely new paragraph. This can be added with the correct formatting, because it is separate from all the other content. 1.5 Adding a new sentence to the new paragraph. Again, because white space changes are not allowed, this will result in the wrong formatting. 1.6 White space changes only. 1.7 Deleting an existing paragraph. OK? Now, the Japanese team come along to translate this. How are you doing this? I was expecting that you would do the following; 1. Take a diff between 1.1 and 1.2. This diff should be relatively easy to follow, because there are no significant white space changes. Translate, and commit, this new text. The Japanese version can be committed with the correct formatting, because (AFAIK) we don't have any translations that are using the Japanese text as the original source. 2. Ignore revision 1.3 completely. 3. Take a diff between revision 1.3 and 1.4, to get the text of the new paragraph. Because this is entirely new text you don't need to spend any effort trying to disentangle it from text that hasn't changed, so the translation process should be much easier. 4. Take a diff between 1.4 and 1.5, and handle this in the same way you handled step 1. 5. Ignore 1.6. [ Actually, this is a bit of a special case. Because of the order of commits to the English version, you could take diffs between 1.4 and 1.6 to add the new paragraph -- this is unlikely to happen in real life. ] 6. Duplicate 1.7, which should be easy to do. That's certainly how I thought the process was working. However, you make it sound that what you're actually doing is taking a diff between 1.1 and 1.7, which will include all the white space changes, even though they were originally entered as separate commits. If this *is* what you're doing (and I stress that I'm confused now as to whether it is or not) then I can see why you're having problems. To requote your points above: > the following steps will help the translator teams. > > 1. Announce to the -doc list. > The translated version (Japanese, Chinese, etc.) is not synced > with the English version very often. So, tranlation teams need > time to work. In some cases, they need two or three weeks or more. > For example, most of Japanese doc team members are very busy > in January, February and March. Some of them must prepare for > the examination of their university or highschool, and some of > them must work hard in their office. > > 2. Make sure that all tranlated version are synched with the English > version. > > 3. Refill or rewrite the English version. > No *real* change please. Insert/delete whitespaces and newlines > only. > > 4. Commit the changes in the step 3. We shouldn't need to do this (at least, I don't think we should, unless I'm missing something seriously fundamental). One of the big advantages of CVS is that we don't need to agree in advance on a 'synchronisation' point. You can pick which revision you want to sync to, based on what's convenient to you. Right? Comments from members of other translation teams would be useful at this point. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 11:52:27 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 6295215A2F; Wed, 25 Aug 1999 11:52:07 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA04562; Wed, 25 Aug 1999 19:37:46 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id MAA05413; Wed, 25 Aug 1999 12:38:19 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 12:38:19 +0100 From: Nik Clayton To: "Jordan K. Hubbard" Cc: Nik Clayton , jack , current@FreeBSD.ORG, asami@freebsd.org, doc@freebsd.org Subject: Re: Docs blows up make release Message-ID: <19990825123819.A2177@kilt.nothing-going-on.org> References: <19990822110511.A89933@kilt.nothing-going-on.org> <3164.935357152@localhost> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary=NzB8fVQJ5HfG6fxh X-Mailer: Mutt 0.95.4i In-Reply-To: <3164.935357152@localhost>; from Jordan K. Hubbard on Sun, Aug 22, 1999 at 02:25:52PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --NzB8fVQJ5HfG6fxh Content-Type: text/plain; charset=us-ascii [ I've added Satoshi Asami to the cc: list -- I figure he's almost certainly on -current, but I wanted to make sure he sees this and can add his input as necessary. I've also added -doc, for information. ] On Sun, Aug 22, 1999 at 02:25:52PM -0700, Jordan K. Hubbard wrote: > Nik Clayton wrote: > > For the immediate future, it looks like it will -- it seems as though > > we don't have the man power to make the necessary changes to sysinstall > > to support "installing the docs as packages", so I'm going to fix up > > src/release/Makefile as necessary to cope with the new directory structure. Just an update on that. I've been working on this with Jack O'Neill, and if the reports are favourable I'll have one small patch to src/release/Makefile and one small patch to doc/*/Makefile to go in some time in the next 48 hours or so which should get release builds working. Note that this won't include any fixes to teach sysinstall about the new paths under /usr/share/doc/, although you should have seen a patch I sent you about that by now. > I also should note that there's nothing to preclude supplying the docs > as packages *also*, assuming that they appear in the INDEX and get > built as part of Satoshi's ports build. This assumes that the documentation is also listed in the ports tree. I don't think this is a great idea -- more specifically, I don't think this is a great idea as the primary mechanism for making packages of the documentation. I've got no problems with it being another way to make doc packages. As the comment for ports/japanese/handbook says, "this is pretty useless as a port, but is here so I can build a package -- Satoshi". This makes the ports tree have a dependency on the doc tree. I don't think this dependency should be there. It's bad enough that the src/ tree depends on doc/ (and the reason I want the documentation available as packages is to remove this dependency), having ports depend on the doc tree as well just means that when things go out of sync in doc for a while I get both you and Satoshi complaining at me, instead of just you :-) Putting the package building rules in the doc/ Makefiles also (and this is just my personal opinion) makes it easier for people to see how the documentation packages are built. The ports Makefile structure is a marvel, but it contains a lot of code that's not necessary for building documentation packages (the "automagically add man pages to the PLIST i" code, for example) that makes it more difficult for the interested learner to browse and understand what's going on. I've attached the patch to docproj.docbook.mk that tells it how to build packages to this message. To use it. 1. Checkout a recent copy of the doc/ repository. 2. Patch doc/share/mk/docproj.docbook.mk with the attached patch. 3. Pick a directory, such as the English FAQ # cd doc/en_US.ISO_8859-1/books/faq 4. Make sure that a COMMENT and DESCR file exist. I haven't committed any of these yet, so the simplest thing to do is # touch COMMENT DESCR 5. Run "make package", ensuring that the FORMATS variable is set to the formats you want to build. # make "FORMATS=html html-split ps pdf rtf" package 6. Sit back and relax, it takes a while. When it's finished, look at the .tgz files that have been created. Note that package building *will* update the installed documentation under /usr/share/doc/. If there's a way to work around this (so that you can build the package containing files in one directory, but so that when you run pkg_add(1) the files are installed in a different directory) I'd like to know about it. This is still proof of concept. For example, when it's finished, it would be nice if the DESCR could be automatically generated by pulling out the ... that might be in the source, and the name of the generated package should probably be something like ...tgz so faq.en_US.ISO_8859-1.pdf.tgz But I think it currently fits the 80/20 rule reasonably well. If you put COMMENT and DESCR files in all the appropriate directories you should certainly be able to do something like # cd /usr/doc # make "FORMATS=html html-split ps pdf rtf" package # find . -name \*.tgz -exec scp {} wcarchive:/archive/pub/FreeBSD/doc \; which is how I intend to automate building these things and ensuring that wcarchive is kept up to date. Does that all make sense? I don't think there's anything there that's egregiously stupid, but it's been known to happen before :-) N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> --NzB8fVQJ5HfG6fxh Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=patch Index: docproj.docbook.mk =================================================================== RCS file: /home/ncvs/doc/share/mk/docproj.docbook.mk,v retrieving revision 1.9 diff -u -r1.9 docproj.docbook.mk --- docproj.docbook.mk 1999/08/19 00:07:09 1.9 +++ docproj.docbook.mk 1999/08/22 07:40:27 @@ -90,7 +90,7 @@ JADEOPTS= ${JADEFLAGS} -c ${FREEBSDCATALOG} -c ${DSSSLCATALOG} -c ${DOCBOOKCATALOG} -c ${JADECATALOG} ${EXTRA_CATALOGS:S/^/-c /g} -KNOWN_FORMATS= html html-split html-split.tar txt rtf ps pdf tex dvi tar doc +KNOWN_FORMATS= html html-split html-split.tar txt rtf ps pdf tex dvi tar # ------------------------------------------------------------------------ # If DOC_PREFIX is not set then try and generate a sensible value for it. @@ -279,6 +279,36 @@ validate: nsgmls -s -c ${FREEBSDCATALOG} -c ${DOCBOOKCATALOG} ${EXTRA_CATALOGS:S/^/-c /g} ${DOC}.sgml + +# ------------------------------------------------------------------------ +# +# Package building +# + +# +# Build a list of package targets for each output format. Each package +# target depends on the corresponding install target running. +# +.for _curformat in ${KNOWN_FORMATS} +_cf=${_curformat} +package-${_curformat}: install-${_curformat} + rm PLIST +.if ${_cf} == "html-split" + cp HTML.manifest PLIST +.else + echo ${DOC}.${_curformat} > PLIST +.endif + pkg_create -v -c COMMENT -d DESCR -f PLIST -p ${DESTDIR} \ + ${DOC}.${_curformat}.tgz +.endfor + +# +# Build one or more pkg_add(1)'able packages, based on all the current +# values of ${FORMATS}. Do this by listing all the appropriate +# package-* targets as dependencies. +# + +package: ${FORMATS:S/^/package-/} # ------------------------------------------------------------------------ # --NzB8fVQJ5HfG6fxh-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 11:54: 2 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 6596215375; Wed, 25 Aug 1999 11:53:54 -0700 (PDT) (envelope-from nik@FreeBSD.org) Received: (from nik@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA17832; Wed, 25 Aug 1999 11:53:54 -0700 (PDT) (envelope-from nik@FreeBSD.org) Date: Wed, 25 Aug 1999 11:53:54 -0700 (PDT) From: Message-Id: <199908251853.LAA17832@freefall.freebsd.org> To: andy@icc.surw.chel.su, nik@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/13366: Update doc: doc/ru/FAQ/applications.sgml Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Update doc: doc/ru/FAQ/applications.sgml State-Changed-From-To: open->closed State-Changed-By: nik State-Changed-When: Wed Aug 25 11:52:51 PDT 1999 State-Changed-Why: Committed, thanks. Roll on the DocBook version (yell if you need any help with that). To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 12:20:17 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gw.caamora.com.au (jonath5.lnk.telstra.net [139.130.41.237]) by hub.freebsd.org (Postfix) with ESMTP id 4641214C31 for ; Wed, 25 Aug 1999 12:19:59 -0700 (PDT) (envelope-from jon@gw.caamora.com.au) Received: (from jon@localhost) by gw.caamora.com.au (8.8.8/8.8.8) id FAA07050; Thu, 26 Aug 1999 05:19:24 +1000 (EST) (envelope-from jon) Message-ID: <19990826051922.A6868@caamora.com.au> Date: Thu, 26 Aug 1999 05:19:22 +1000 From: jonathan michaels To: Roelof Osinga , k4n _ Cc: freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Mail-Followup-To: Roelof Osinga , k4n _ , freebsd-doc@FreeBSD.ORG References: <19990817233734.80790.qmail@hotmail.com> <37BB0AEE.ED7B311F@nisser.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: <37BB0AEE.ED7B311F@nisser.com>; from Roelof Osinga on Wed, Aug 18, 1999 at 09:35:10PM +0200 X-Operating-System: FreeBSD gw.caamora.com.au 2.2.7-RELEASE i386 X-Mood: i'm alive, if it counts Organisation: Caamora, PO Box 144, Rosebery NSW 1445 Australia Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 18, 1999 at 09:35:10PM +0200, Roelof Osinga wrote: > k4n _ wrote: > > > > I thought maybe you would be interested in a free website redesign(or > > something) so I downloaded the HTML for your site, and made a few changes. I > > made the background black, redid the FreeBSD logo slightly, and darkened the > > logos at the bottom to match the color scheme. If you are interested I can > > send you a copy, I think it looks pretty cool. See you later > > Why do people always assume that dark is cool. The purpose of a website > is to convey information. That means good readability, not looks. Whereas or someting long the lines of disabled people with various levels of visual acuity loss, the poor screen resolutions used by crts thes days, generally 70-90 dpi and finally those with colour diferentiation and distortion difficulties > beauty lies in the eye of the beholder, readability assuredly does not. sure is, and, teh freebsd is bearly readable because of teh all white background .. far better fro it to been a dark blue or cft black, i.e. all guns quiesent, ps this is not a real black, it depends on teh glass coatings. the phosphor types, thier retentivity and ignition characteristics. but this is not a technical discussion about crt construction, and or human visual acuity responce, is it ? > Barring the by now ancient amber CRT phosphor colors most research > shows that black on white (note the order) is best readable. philips researches (eindhoven - please excuse the name spelling, incase i get it really wrong) in conjunction with wiether siemans and or nixdorf of germany discoverd that a particular shade of blue (fairly luminescent, but not very 'visually bright') was the best 'colour' to use as teh std or default background state of teh viisble crt page. thier was a small hitch in this whole process, viola, people didn;t like the colour and so teh crt never saw the light of day .. latent puns intended. with regrds to this particular shade of blue, it was found that it induced the least amount (virtually zero) of muscle jitter (stress) because teh eye didn't "have to look at it", that is the background essentiall disapeard. thier were also other issues, regardsing and inparticular how the rods and conse in the retina actually responded to that particular frequency distribution (er, the colour of the lighting) o'well their is no accounting fro fashion or peoples inate stupidity ... grin. please note i use a fairly old nec multisync mk 1 with a not so "ergonomically correct" (fortunately for me) i.e a very harsh (high contrast) crt, nec no longer makes this kind of tube. to many americans sued becaue of eye strain i suppose ? i also use exclusively white on black, even when i (on very rare ocassions) venture into x11 realm. > The FreeBSD site is emminently readable, i challange your view .. the freebsd site is bearly viewable, let alone readable, by anyone who dosent have (as teh americans say 20/20 visual acuity and a fairly std colour diferantion. this doenst adress other such issues as page layout fro people who have to use a font that is say 20-30 percent bigger, thsi by the way is the NORMAL range fro comfort variation on the stasard poor quality monitor (less that about 150 dpi). "disabled" people require font re-sizeings measured in 100's of percent to achieve reability, not a meager 20 to thirty percent. > whereas the old freshmeat site > was not. In fact with my previous monitor's settings I couldn't even > read that site without upping the brightness (I'm a programmer, for > text high contrast is needed contrary to the high brightness for graphics > work). Clearly I was not alone in that they changed to a much > brighter color scheme. As well as black"er" on white lettering. sounds like you and all the rest know (i suppose it would be better to say, understand) very little about how to set up a monitor package to get the best 'screen to eye' connectivity. in short, the rooms ambient lighting -- its colour temperature and placement with respect to the crt screen and your eyes will determine how good or bad a particular monitor will "look". people make the same mistake with telivision set setiing up as well, by the way. once you get this right, you can use very low contrast and brightness settings on you monitor. this will in turn preserg you output guns, teh eht stage transformer and vht capacitor stage .. no more expensive eht circuit replaceemnts from over dirven componets. and, so the list continues. please note, i've just touched upon some of teh relevent issues to this discussion, thier are many others that would require much indepth understaninding by al parties concerned. what i've tried to present in a fairly dispassionate manner are some of the issue that require the least amount of effort to give signifficant advantage to all people who are inside the so called 'standard envelope' and that would greatly aid teh visability of teh site by thoose not so well endowed, either by God or as a result of accident. regards, jonathan ... toilets may be "disabled", people are not. -- =============================================================================== Jonathan Michaels PO Box 144, Rosebery, NSW 1445 Australia =========================================================== To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 12:34:30 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gw.caamora.com.au (jonath5.lnk.telstra.net [139.130.41.237]) by hub.freebsd.org (Postfix) with ESMTP id ACEAA15CC7 for ; Wed, 25 Aug 1999 12:34:02 -0700 (PDT) (envelope-from jon@gw.caamora.com.au) Received: (from jon@localhost) by gw.caamora.com.au (8.8.8/8.8.8) id FAA07089; Thu, 26 Aug 1999 05:31:52 +1000 (EST) (envelope-from jon) Message-ID: <19990826053151.B6868@caamora.com.au> Date: Thu, 26 Aug 1999 05:31:51 +1000 From: jonathan michaels To: Peter McGarvey , Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com Cc: freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Mail-Followup-To: Peter McGarvey , Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG References: <199908241123.HAA59303@lakes.dignus.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: ; from Peter McGarvey on Tue, Aug 24, 1999 at 04:04:05PM +0100 X-Operating-System: FreeBSD gw.caamora.com.au 2.2.7-RELEASE i386 X-Mood: i'm alive, if it counts Organisation: Caamora, PO Box 144, Rosebery NSW 1445 Australia Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 04:04:05PM +0100, Peter McGarvey wrote: > Web styles/colour schemes are something I feel strongly about. i don't since i started using lynx, the text format of the freebsd site isn't too bad, as an aside. > I'm dyslexic. A bad colour scheme make my life hell. "welcome to the machine" ... dsylexic, colour blind and significant neurological damage that makes typing difficult. i've trimmed the rest of you post as it says (by way of example) what i tried to say in my earleir post in a far more general manner. regards, jonathan ... tiolets are "disabled", people are not. -- =============================================================================== Jonathan Michaels PO Box 144, Rosebery, NSW 1445 Australia =========================================================== To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 12:37: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gw.caamora.com.au (jonath5.lnk.telstra.net [139.130.41.237]) by hub.freebsd.org (Postfix) with ESMTP id 57CD8153A9 for ; Wed, 25 Aug 1999 12:36:56 -0700 (PDT) (envelope-from jon@gw.caamora.com.au) Received: (from jon@localhost) by gw.caamora.com.au (8.8.8/8.8.8) id FAA07105; Thu, 26 Aug 1999 05:36:38 +1000 (EST) (envelope-from jon) Message-ID: <19990826053637.C6868@caamora.com.au> Date: Thu, 26 Aug 1999 05:36:37 +1000 From: jonathan michaels To: Gary Kline , Peter McGarvey Cc: Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Mail-Followup-To: Gary Kline , Peter McGarvey , Thomas David Rivers , k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG References: <199908241123.HAA59303@lakes.dignus.com> <19990824101738.B2875@athena.tera.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: <19990824101738.B2875@athena.tera.com>; from Gary Kline on Tue, Aug 24, 1999 at 10:17:38AM -0700 X-Operating-System: FreeBSD gw.caamora.com.au 2.2.7-RELEASE i386 X-Mood: i'm alive, if it counts Organisation: Caamora, PO Box 144, Rosebery NSW 1445 Australia Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 24, 1999 at 10:17:38AM -0700, Gary Kline wrote: > On Tue, Aug 24, 1999 at 04:04:05PM +0100, Peter McGarvey wrote: > Has anybody on the list found any websites with presentation > information? yes, sorry, i don't have the information .. but, if you do a web search on the topic of "colour blind(ness)" some fairly relevent infromation can be gotten, most of it reasonably accurate and up to date .. a web first. regards, jonathan ... tiolets are "disabled", people are not. -- =============================================================================== Jonathan Michaels PO Box 144, Rosebery, NSW 1445 Australia =========================================================== To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 12:48:13 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gw.caamora.com.au (jonath5.lnk.telstra.net [139.130.41.237]) by hub.freebsd.org (Postfix) with ESMTP id 4139F15364 for ; Wed, 25 Aug 1999 12:47:46 -0700 (PDT) (envelope-from jon@gw.caamora.com.au) Received: (from jon@localhost) by gw.caamora.com.au (8.8.8/8.8.8) id FAA07141; Thu, 26 Aug 1999 05:47:12 +1000 (EST) (envelope-from jon) Message-ID: <19990826054711.D6868@caamora.com.au> Date: Thu, 26 Aug 1999 05:47:11 +1000 From: jonathan michaels To: Roelof Osinga , Gary Kline Cc: Kent Stewart , Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Mail-Followup-To: Roelof Osinga , Gary Kline , Kent Stewart , Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, freebsd-doc@FreeBSD.ORG References: <199908242049.NAA05311@athena.tera.com> <37C347CE.A49ED05C@nisser.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: <37C347CE.A49ED05C@nisser.com>; from Roelof Osinga on Wed, Aug 25, 1999 at 03:33:02AM +0200 X-Operating-System: FreeBSD gw.caamora.com.au 2.2.7-RELEASE i386 X-Mood: i'm alive, if it counts Organisation: Caamora, PO Box 144, Rosebery NSW 1445 Australia Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 25, 1999 at 03:33:02AM +0200, Roelof Osinga wrote: > Gary Kline wrote: > > > > According to Kent Stewart: > > > > > > > > > Gary Kline wrote: > > > > > > > > ... > > > > Has anybody on the list found any websites with presentation > > > > information? > > > > > > The only one I know of is > > > http://webknowhow.net/dir/Design/Miscellaneous/. There site has much > > > more. It is mostly links to somewhere else. Helen Triantafillou has a > > > site at http://users.hol.gr/~andreas/hexcolor.htm that lists many > > > combinations of colors and their hex values. > > > > > > > Noted and saved away, thanks much. > > If that holds your interest you might want to take a look at > the Kolere! Applet. Something I wrote whilest test JBuilder 1 and > needed to toy with colorschemes and their effect on various monitors. > You can find it at http://eboa.com/Java/KolereApplet.html > > > I asked one of our GUI wizards and he suggested doing what Netscape > > and other commercial apps did. > > Wise advise, though I would change that to looking at commercial > sites since we're talking about websites. "commercial sites", roelof are created by people like you, me and the rest of the people in this list, this thread using freebsd, et al .. what i'm trying to say is that they are "nothing special". even wiser advice wold be to colour correct you own crt, adjust its gamma correctons values and set the colour temerature the principle 'pigments' -- cyan, magenta, green as well as the monitor+crt+graphics card and drivers idea of black and white. once you establish this base platform then one can do what you are trying to do with any from of repeatabilty or security of outcome. regards, jonathan toilets are "disabled", people are not. -- =============================================================================== Jonathan Michaels PO Box 144, Rosebery, NSW 1445 Australia =========================================================== To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 12:59:19 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gershwin.tera.com (gershwin.tera.com [207.224.230.28]) by hub.freebsd.org (Postfix) with ESMTP id A67E414C4F for ; Wed, 25 Aug 1999 12:59:10 -0700 (PDT) (envelope-from kline@tera.com) Received: from athena.tera.com (athena.tera.com [207.224.230.169]) by gershwin.tera.com (8.8.8/8.8.8) with ESMTP id MAA25691; Wed, 25 Aug 1999 12:58:33 -0700 (PDT) From: Gary Kline Received: (from kline@localhost) by athena.tera.com (8.7.5/8.7.3) id MAA13107; Wed, 25 Aug 1999 12:58:32 -0700 (PDT) Message-Id: <199908251958.MAA13107@athena.tera.com> Subject: Re: FreeBSD webdesign In-Reply-To: <19990826053637.C6868@caamora.com.au> from jonathan michaels at "Aug 26, 99 05:36:37 am" To: jon@caamora.com.au (jonathan michaels) Date: Wed, 25 Aug 1999 12:58:30 -0700 (PDT) Cc: kline@tera.com, Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, roelof@nisser.com, freebsd-doc@FreeBSD.ORG X-Mailer: ELM [version 2.4ME+ PL23 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org According to jonathan michaels: > On Tue, Aug 24, 1999 at 10:17:38AM -0700, Gary Kline wrote: > > On Tue, Aug 24, 1999 at 04:04:05PM +0100, Peter McGarvey wrote: > > > Has anybody on the list found any websites with presentation > > information? > > yes, sorry, i don't have the information .. but, if you do a web > search on the topic of "colour blind(ness)" some fairly > relevent infromation can be gotten, most of it reasonably > accurate and up to date .. a web first. > Color-blindness is one consideration; as are font sizes and the entire issue of what widgetLabels or popups look best in which dimensions. I'll probably stick with a bold black typeface, and lighten the grey. Eventually, giving users their choice is the best solution. gary > -- Gary Kline Tera Computer Company To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 13:10:53 1999 Delivered-To: freebsd-doc@freebsd.org Received: from wopr.caltech.edu (wopr.caltech.edu [131.215.240.222]) by hub.freebsd.org (Postfix) with ESMTP id 6FF1014FF5 for ; Wed, 25 Aug 1999 13:10:50 -0700 (PDT) (envelope-from mph@wopr.caltech.edu) Received: (from mph@localhost) by wopr.caltech.edu (8.9.3/8.9.1) id NAA37849; Wed, 25 Aug 1999 13:08:46 -0700 (PDT) (envelope-from mph) Date: Wed, 25 Aug 1999 13:08:45 -0700 From: Matthew Hunt To: jonathan michaels Cc: Roelof Osinga , k4n _ , freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Message-ID: <19990825130845.B36450@wopr.caltech.edu> References: <19990817233734.80790.qmail@hotmail.com> <37BB0AEE.ED7B311F@nisser.com> <19990826051922.A6868@caamora.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990826051922.A6868@caamora.com.au>; from jonathan michaels on Thu, Aug 26, 1999 at 05:19:22AM +1000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 05:19:22AM +1000, jonathan michaels wrote: > or someting long the lines of disabled people with various > levels of visual acuity loss, the poor screen resolutions used > by crts thes days, generally 70-90 dpi and finally those with > colour diferentiation and distortion difficulties I'll be even more reactionary, reaching back to the good ol' days when HTML didn't have a way to specify text and background colors. I don't think web pages should be altering the background and text colors that I have selected (traditional Mosaic black-on-grey). -- Matthew Hunt * Stay close to the Vorlon. http://www.pobox.com/~mph/ * To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 13:11:38 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id AD88615258 for ; Wed, 25 Aug 1999 13:11:35 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id NAA23635; Wed, 25 Aug 1999 13:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from buffalo.ru.ac.za (buffalo.ru.ac.za [146.231.128.3]) by hub.freebsd.org (Postfix) with ESMTP id 3A0EC14CCF for ; Wed, 25 Aug 1999 13:01:49 -0700 (PDT) (envelope-from nbm@mithrandr.moria.org) Received: from duca.dialup.ru.ac.za ([146.231.98.24] helo=mithrandr.moria.org) by buffalo.ru.ac.za with esmtp (Exim 3.03 #2) id 11JjEm-0005PN-00 for FreeBSD-gnats-submit@freebsd.org; Wed, 25 Aug 1999 22:01:37 +0200 Received: (qmail 86659 invoked by uid 1001); 25 Aug 1999 19:17:26 -0000 Message-Id: <19990825191726.86658.qmail@mithrandr.moria.org> Date: 25 Aug 1999 19:17:26 -0000 From: nbm@rucus.ru.ac.za Reply-To: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13379: add obj'ability to doc build Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13379 >Category: docs >Synopsis: add obj'ability to doc build >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Aug 25 13:10:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Neil Blakey-Milner >Release: FreeBSD 4.0-CURRENT i386 >Organization: Rhodes University Computer Users' Society >Environment: FreeBSD mithrandr.moria.org 4.0-CURRENT FreeBSD 4.0-CURRENT #0: Sat Aug 7 11:34:36 SAST 1999 root@mithrandr.moria.org:/usr/src/sys/compile/MITHRANDR i386 >Description: Add ability to use obj-related abilities to the doc build. This'll help with read-only trees, and all sorts of other funky things. >How-To-Repeat: make obj all >Fix: cvs diff: Diffing . Index: docproj.docbook.mk =================================================================== RCS file: /home/nbm/ncvs/doc/share/mk/docproj.docbook.mk,v retrieving revision 1.9 diff -u -r1.9 docproj.docbook.mk --- docproj.docbook.mk 1999/08/19 00:07:09 1.9 +++ docproj.docbook.mk 1999/08/25 17:00:29 @@ -76,6 +76,7 @@ .endif DOC?= ${.CURDIR:T} +MASTERDOC?= ${.CURDIR}/${DOC}.sgml DOC_INSTALL_PREFIX?= /usr/local/share/doc/fdp @@ -223,49 +224,49 @@ all: ${_docs} index.html HTML.manifest: ${SRCS} - ${JADE} -V html-manifest -ioutput.html ${JADEOPTS} -d ${DSLHTML} -t sgml ${DOC}.sgml + ${JADE} -V html-manifest -ioutput.html ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} -tidy -i -m -f /dev/null ${TIDYFLAGS} *.html ${DOC}.html: ${SRCS} - ${JADE} -ioutput.html -V nochunks ${JADEOPTS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html - -tidy -i -m -f /dev/null ${TIDYFLAGS} ${DOC}.html + ${JADE} -ioutput.html -V nochunks ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} > ${.TARGET} + -tidy -i -m -f /dev/null ${TIDYFLAGS} ${.TARGET} ${DOC}.html-split.tar: HTML.manifest tar cf ${.TARGET} `xargs < HTML.manifest` ${DOC}.txt: ${DOC}.html - lynx -nolist -dump ${DOC}.html > ${DOC}.txt + lynx -nolist -dump ${.ALLSRC} > ${.TARGET} ${DOC}.rtf: ${SRCS} - ${JADE} -Vrtf-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t rtf ${DOC}.sgml + ${JADE} -Vrtf-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t rtf -o ${.TARGET} ${MASTERDOC} ${DOC}.doc: ${SRCS} - ${JADE} -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t doc ${DOC}.sgml + ${JADE} -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t doc -o ${.TARGET} ${MASTERDOC} ${DOC}.tex: ${SRCS} - ${JADE} -Vtex-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t tex ${DOC}.sgml + ${JADE} -Vtex-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t tex -o ${.TARGET} ${MASTERDOC} ${DOC}.dvi: ${DOC}.tex @echo "==> TeX pass 1/3" - -tex "&jadetex" ${DOC}.tex + -tex "&jadetex" ${.ALLSRC} @echo "==> TeX pass 2/3" - -tex "&jadetex" ${DOC}.tex + -tex "&jadetex" ${.ALLSRC} @echo "==> TeX pass 3/3" - -tex "&jadetex" ${DOC}.tex + -tex "&jadetex" ${.ALLSRC} ${DOC}.pdf: ${DOC}.tex @echo "==> PDFTeX pass 1/3" - -pdftex "&pdfjadetex" ${DOC}.tex + -pdftex "&pdfjadetex" ${.ALLSRC} @echo "==> PDFTeX pass 2/3" - -pdftex "&pdfjadetex" ${DOC}.tex + -pdftex "&pdfjadetex" ${.ALLSRC} @echo "==> PDFTeX pass 3/3" - pdftex "&pdfjadetex" ${DOC}.tex + pdftex "&pdfjadetex" ${.ALLSRC} ${DOC}.ps: ${DOC}.dvi - dvips -o ${DOC}.ps ${DOC}.dvi + dvips -o ${.TARGET} ${.ALLSRC} -${DOC}.tar: - tar cf ${.TARGET} ${SRCS} +${DOC}.tar: ${SRCS} + tar cf ${.TARGET} ${.ALLSRC} # ------------------------------------------------------------------------ # >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 14: 5:52 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nisser.com (n2000039.telekabel.chello.nl [212.187.0.39]) by hub.freebsd.org (Postfix) with ESMTP id B77B8153F4 for ; Wed, 25 Aug 1999 14:05:49 -0700 (PDT) (envelope-from roelof@nisser.com) Received: from nisser.com (roelof [10.0.0.2]) by nisser.com (8.9.3/8.9.2) with ESMTP id XAA78588; Wed, 25 Aug 1999 23:03:44 +0200 (CEST) (envelope-from roelof@nisser.com) Message-ID: <37C45A26.89B18AB5@nisser.com> Date: Wed, 25 Aug 1999 23:03:34 +0200 From: Roelof Osinga Organization: eboa - engineering buro Office Automation X-Mailer: Mozilla 4.6 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: jonathan michaels Cc: Gary Kline , Kent Stewart , Networks.Manager@rncm.ac.uk, rivers@dignus.com, k4n@hotmail.com, freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign References: <199908242049.NAA05311@athena.tera.com> <37C347CE.A49ED05C@nisser.com> <19990826054711.D6868@caamora.com.au> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org jonathan michaels wrote: > > On Wed, Aug 25, 1999 at 03:33:02AM +0200, Roelof Osinga wrote: > > > > Wise advise, though I would change that to looking at commercial > > sites since we're talking about websites. > > "commercial sites", roelof are created by people like you, me > and the rest of the people in this list, this thread using > freebsd, et al .. what i'm trying to say is that they are > "nothing special". If you mean people with 2 arms, 2 legs, 1 nose then, yes. If you mean people with like skills, practice and information then not necessarily. E.g. Microsoft has at least one huge UI research lab it stands to reason they put it to good use. Don't know about you, but I sure don't have those kind of facilities. Same goes for other facilities. Same for team size and talent distribution. Also, it's meant as a q&d heuristic not as career advice. > even wiser advice wold be to colour correct you own crt, adjust > its gamma correctons values and set the colour temerature the > principle 'pigments' -- cyan, magenta, green as well as the > monitor+crt+graphics card and drivers idea of black and white. > > once you establish this base platform then one can do what you > are trying to do with any from of repeatabilty or security of > outcome. Same advice as in the other email you send but you're overlooking one major, nay huge, fact. You have absolutely no control whatsoever over the CRT, graphics card, color temperature, brightness, contrast, ambient lighting, eye sight and whatever else may influence the overall graphic impact of your masterwork at the site where the sight is experienced, so to speak. That alone ties your hands severely. Hence it is no use to overengineer these things. KISS still rules. Maybe a light gray or sky blue is better, but only if you don't encounter old ratty monitors facing the sun. So in your other reply you said <> But that only says that the sites I compared the FreeBSD site to, as the old freshmeat one, were utterly unviewable by that target audience. IOW it's a relative thing. Also, my eye sight may be 20/20 but that monitor more than made up for it . Finally and again meant as heuristic the W3C site about Web accessability (http://www.w3.org/1999/05/WCAG-REC-test) uses bigger, bold, black letters on a plain white background. Those folk are the specialists on this topic . Roelof -- Home is where the (@) http://eboa.com/ is. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 14:29:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.cdrom.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 12CF014DC8; Wed, 25 Aug 1999 14:29:16 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.cdrom.com (8.9.3/8.9.3) with ESMTP id OAA16787; Wed, 25 Aug 1999 14:27:05 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) To: Nik Clayton Cc: "Jordan K. Hubbard" , jack , current@freebsd.org, asami@freebsd.org, doc@freebsd.org Subject: Re: Docs blows up make release In-reply-to: Your message of "Wed, 25 Aug 1999 12:38:19 BST." <19990825123819.A2177@kilt.nothing-going-on.org> Date: Wed, 25 Aug 1999 14:27:05 -0700 Message-ID: <16783.935616425@localhost> From: "Jordan K. Hubbard" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > Just an update on that. I've been working on this with Jack O'Neill, and > if the reports are favourable I'll have one small patch to > src/release/Makefile and one small patch to doc/*/Makefile to go in some > time in the next 48 hours or so which should get release builds working. Great, sounds good. > Note that this won't include any fixes to teach sysinstall about the new > paths under /usr/share/doc/, although you should have seen a patch I sent > you about that by now. Hmm, I still have 3000 mails I'm going through here... sysinstall required changes? I thought everything was still under /usr/share/doc, or are the subdirs different now? > This assumes that the documentation is also listed in the ports tree. > > I don't think this is a great idea -- more specifically, I don't think > this is a great idea as the primary mechanism for making packages of > the documentation. I've got no problems with it being another way to > make doc packages. Hmmm. How else were you thinking of making "doc packages" then - wasn't that the whole project you were working on? > This makes the ports tree have a dependency on the doc tree. I don't think > this dependency should be there. It's bad enough that the src/ tree > depends on doc/ (and the reason I want the documentation available as > packages is to remove this dependency), having ports depend on the doc tree > as well just means that when things go out of sync in doc for a while I get > both you and Satoshi complaining at me, instead of just you :-) Erm, I think the ports tree is pretty darn loose about "dependencies" since they're easily updated. Consider, for example, the fact that some ports are dependent on the organization of binary tarballs over at Netscape, or depend on WordPerfect's linux distribution RPM. Those are some pretty heavy deps, and depending on something in our own doc tree is certainly no worse. :) > Putting the package building rules in the doc/ Makefiles also (and this > is just my personal opinion) makes it easier for people to see how the > documentation packages are built. The ports Makefile structure is a > marvel, but it contains a lot of code that's not necessary for building > documentation packages (the "automagically add man pages to the PLIST > i" code, for example) that makes it more difficult for the interested > learner to browse and understand what's going on. Now this is a point which is more germin. So, you figure on making a similar sort of "package" target under doc? I guess it really doesn't matter where these things live, as long as it's still automated.. - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:14:25 1999 Delivered-To: freebsd-doc@freebsd.org Received: from blues.ghis.net (pppc2-105.eisa.net.au [203.166.251.225]) by hub.freebsd.org (Postfix) with ESMTP id 9DB6F15379 for ; Wed, 25 Aug 1999 15:14:12 -0700 (PDT) (envelope-from jim@blues.ghis.net) Received: (from jim@localhost) by blues.ghis.net (8.9.3/8.9.3) id IAA65502 for doc@FreeBSD.org; Thu, 26 Aug 1999 08:13:11 +1000 (EST) (envelope-from jim) Date: Thu, 26 Aug 1999 08:13:09 +1000 From: Jim Mock To: doc@FreeBSD.org Subject: http://www.freebsd.org/support.html#user Message-ID: <19990826081309.A65454@blues.ghis.net> Reply-To: jim@blues.ghis.net Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre1i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi folks, I recall this being brought up before, but since it hasn't been done yet I figured I'd bring it up again. Does anyone have any objections to changing the location name of the user group listing to some other color (preferably bold black)? As was mentioned the last time this topic was brought up, most people associate blue with links. I also think something bold would stand out a little better. If no one objects, I'll go through support.sgml and make and commit the changes. I would like to hear other opinions on what color everyone thinks they should be before I do it though. - Jim -- - Jim Mock - jim@blues.ghis.net - systems administrator - ghis.NET - - work: http://www.ghis.net/ - personal: http://www.ghis.net/~jim/ - - FreeBSD 'zine: http://www.freebsdzine.org/ - jim@freebsdzine.org - - The FreeBSD Project -- http://www.FreeBSD.org/ - jim@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:14:44 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sand4.global.net.uk (sand4.global.net.uk [194.126.80.248]) by hub.freebsd.org (Postfix) with ESMTP id 72DF015C41; Wed, 25 Aug 1999 15:14:27 -0700 (PDT) (envelope-from mark@globalnet.co.uk) Received: from p33s13a06.client.global.net.uk ([195.147.221.52] helo=marder-1.) by sand4.global.net.uk with esmtp (Exim 2.12 #1) id 11JlIq-0005Xm-00; Wed, 25 Aug 1999 23:13:56 +0100 Received: (from mark@localhost) by marder-1. (8.9.2/8.8.8) id XAA02485; Wed, 25 Aug 1999 23:06:42 +0100 (BST) (envelope-from mark) Date: Wed, 25 Aug 1999 23:06:41 +0100 From: Mark Ovens To: Nik Clayton Cc: doc@freebsd.org Subject: Re: How to build DocBook docs? Message-ID: <19990825230641.C265@marder-1> References: <19990822235910.F271@marder-1> <19990823134838.A2121@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.3i In-Reply-To: <19990823134838.A2121@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 01:48:38PM +0100 Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 23, 1999 at 01:48:38PM +0100, Nik Clayton wrote: > On Sun, Aug 22, 1999 at 11:59:11PM +0100, Mark Ovens wrote: > > Are there any instructions anywhere on building the new (DocBook) > > docs? I can build the LinuxDoc ones OK, but the DocBook ones just > > generates lots of errors from jade, like: > > > > cannot open "/usr/local/share/sgml/docbook/dsssl/modular/catalog" (No such file or directory) > > Take a look in /var/db/pkg, and pkg_delete(1) anything you have installed > with "docbook" in the package name (docbook-*, and dsssl-docbook-* probably). > > Then > > # cd /usr/ports/textproc > # cd docbook > # make install > # cd ../dsssl-docbook-modular > # make install > > That should fix it. > Nearly. I did what you suggested, after cvsup'ing the ports tree. It now almost builds but gives the following errors/warnings: Quite a few of these - /usr/local/bin/jade:../../../share/sgml/freebsd.dsl:151:49:E: reference to undefined variable "question-answer-label" tidy -i -m -f /dev/null article.html *** Error code 1 (ignored) Lots of these - /usr/local/bin/jade:book.sgml:136:29:E: [xref to QUESTION unsupported] /usr/local/bin/jade:book.sgml:137:38:E: [xref to QUESTION unsupported] And it finally dies like this - /usr/local/bin/jade:staff/chapter.sgml:652:8:E: general entity "a.mtaylor" not defined and no default entity /usr/local/bin/jade:../../../share/sgml/freebsd.dsl:151:49:E: reference to undefined variable "question-answer-label" *** Error code 1 Stop. *** Error code 1 Stop. *** Error code 1 Stop. *** Error code 1 Stop. OK, I'm probably missing some program(s), or something is out of date. Here's everything I've got installed that is connected to building the docs: 31upgrade-1999.03.08 32upgrade-1999.05.20 docbook-1.0 docbook-3.0 docbook-3.1 dsssl-docbook-modular-1.33 iso8879-1986 jade-1.2.1 linuxdoc-1.1 sgmlformat-1.7 tidy-0.7.99.2 So what's missing or out of date? Thanks for all your help Nik. When I get it done I'll submit some more mods/additions. > N > -- > [intentional self-reference] can be easily accommodated using a blessed, > non-self-referential dummy head-node whose own object destructor severs > the links. > -- Tom Christiansen in <375143b5@cs.colorado.edu> > -- STATE-OF-THE-ART: Any computer you can't afford. OBSOLETE: Any computer you own. ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:28:10 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 28EF4150AD for ; Wed, 25 Aug 1999 15:27:57 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id XAA32330; Wed, 25 Aug 1999 23:11:58 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id WAA48983; Wed, 25 Aug 1999 22:03:41 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 22:03:41 +0100 From: Nik Clayton To: Eric Phillips Cc: freebsd-doc@FreeBSD.org Subject: Re: Addition to the online handbook Message-ID: <19990825220341.C45145@kilt.nothing-going-on.org> References: <37BB08B7.67841061@ionet.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <37BB08B7.67841061@ionet.net>; from Eric Phillips on Wed, Aug 18, 1999 at 02:25:43PM -0500 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi Eric, On Wed, Aug 18, 1999 at 02:25:43PM -0500, Eric Phillips wrote: > If a section that explained slices, their average sizes, and thier use in > the BSD filesystem were to be put in the online handbook, this would > probably help someone like myself in the future. Excellent idea! Were you, er, going to submit this? Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:28:30 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 1076E150AD for ; Wed, 25 Aug 1999 15:27:57 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id XAA32331; Wed, 25 Aug 1999 23:11:58 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id WAA49186; Wed, 25 Aug 1999 22:05:15 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 22:05:15 +0100 From: Nik Clayton To: Abe Gnet Arif Cc: freebsd-doc@FreeBSD.org Subject: Re: my firs question Message-ID: <19990825220515.D45145@kilt.nothing-going-on.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Abe Gnet Arif on Sun, Aug 22, 1999 at 10:17:26AM +0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Abe, On Sun, Aug 22, 1999 at 10:17:26AM +0700, Abe Gnet Arif wrote: > How i can get "kern.flp" and "msfroot.flp"...i have already down > load "fdimage.exe" for yours instruction next step is...? (i wana > install FreeBSD tu my PC) ftp://ftp.FreeBSD.org/pub/FreeBSD/floppies/, I think. You'll probably get a faster response if you send questions to the questions@FreeBSD.org mailing list, rather than this one though. Hope that helps. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:28:46 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 4205E150AD; Wed, 25 Aug 1999 15:27:57 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id XAA32332; Wed, 25 Aug 1999 23:11:58 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id WAA48739; Wed, 25 Aug 1999 22:01:46 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 22:01:46 +0100 From: Nik Clayton To: Jun Kuriyama Cc: doc@freebsd.org Subject: Re: docproj.docbook.mk cruft, naming, splitting Message-ID: <19990825220146.B45145@kilt.nothing-going-on.org> References: <19990819141916.A36423@kilt.nothing-going-on.org> <14276.3459.55262.13042Y@localhost.sky.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <14276.3459.55262.13042Y@localhost.sky.rim.or.jp>; from Jun Kuriyama on Thu, Aug 26, 1999 at 12:36:35AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 12:36:35AM +0900, Jun Kuriyama wrote: > From: Nik Clayton > > doc/share/mk/fdp.own.mk > > fdp.docbook.mk > > fdp.install.mk > > fdp.subdir.mk > > I don't like a word "fdp". I think many users who is not interested > in Documentation Project cannot understand objectives of these files. > > I'd like to name them simply like this: > > doc/share/mk/doc.own.mk > doc.docbook.mk > doc.install.mk > doc.subdir.mk Yeah, that's cool. Anyone got anything else they prefer instead? Otherwise we can go with this. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:28:53 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 375FF15361; Wed, 25 Aug 1999 15:27:57 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id XAA32333; Wed, 25 Aug 1999 23:11:59 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id WAA48585; Wed, 25 Aug 1999 22:00:34 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 25 Aug 1999 22:00:34 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: Nik Clayton , Tim Vanderhoek , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990825220034.A45145@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824171937.K65430@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Wed, Aug 25, 1999 at 04:20:27AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 25, 1999 at 04:20:27AM -0700, Satoshi - Ports Wraith - Asami wrote: > * From: Nik Clayton > > * About the only exception to this is if the changes can be carried out > * completely mechanically, and the mechanism to do so is clearly described > * in the commit message (or supporting e-mail / README file, or equivalent). > > The problem is that you can't separate the real change with formatting > change with diff. Yes, you can, but if, and only if, the original committer was considerate enough to ensure that they didn't commit any white space changes. Right? And we're trying to ensure that every FDP committer follows this rule. As an example, look at the English handbook, in the ppp-and-slip/chapter.sgml file, revisions 1.10 and 1.11. You can see in 1.11 that the committer (jkoshy in this case) hasn't rewrapped the lines after he's made changes (with one exception, which is presumably human error). Or revisions 1.14, 1.15, and 1.16 of the eresources/chapter.sgml file. 1.14 is the before the change, and the diff from 1.15 to 1.16 is white space only (and is noted as such in the log) and can be ignored by the translation teams. Or revisions 1.32, 1.33, and 1.34 of ports/chapter.sgml, where the same thing happens. The idea is that we never commit formatting changes and content changes in the same commit. They're always separate. Unless the content and formatting change can be completely automated. For example, the conversion of the FAQ from LinuxDoc to DocBook can be automated, and described. This conversion involves some content changes (elements changing names) and also some white space changes, where elements appear on new lines, and the like). But because it can be completely described, you can safely commit the content and the whitespace changes at the same time. And I know that it can be automated without worrying about the content of the translation, because I followed my own instructions to convert the Chinese FAQ from LinuxDoc to DocBook, without understanding the language it was written in. Yes? If that doesn't make sense (or does make sense but you still think I'm wrong) can you point me at an example in the doc/en* tree of a content commit that also included a whitespace commit? I don't doubt that they exist (as I say, in the early stages of the DocBook conversion I inadvertently made a few myself) but they should be rare, and getting rarer. And, always, if a particular commit is causing the Japanese team (or any of the translation teams) problems, please mention it to the committer concerned, and, if necessary, post a reminder to -doc. It certainly doesn't hurt for us English speaking committers to be reminded every once in a while to make things easier for the translation teams. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:30:25 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id A28D1150AD; Wed, 25 Aug 1999 15:30:10 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id XAA34928; Wed, 25 Aug 1999 23:23:44 +0100 (BST) (envelope-from nik) Date: Wed, 25 Aug 1999 23:23:43 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990825232343.A34546@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Sun, Aug 22, 1999 at 02:43:33AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Aug 22, 1999 at 02:43:33AM -0700, Satoshi - Ports Wraith - Asami wrote: > Also, the Japanese PS and PDF handbook generation is still broken > since the Linuxdoc -> Docbook switchover. Is anyone going to fix > that? I'm not saying you should fix it, but since you are the one > that proposed the switch and the one that implemented it, you should > at least make sure you have someone signed up to fix it (ideally > before the switchover). Now that I know about it, I've got people interested in working on this. Could someone from the Japanese team please take 5 or 10 minutes to put together a very short DocBook article (in Japanese) that shows the problem. 5 or 6 paragraphs worth will be fine. At the moment, the only samples I've got are the FAQ and the Handbook, which are quite large, and create copious amounts of output. Smaller samples would make the debugging process much easier. Thanks. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 15:50: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id D97CF151E2 for ; Wed, 25 Aug 1999 15:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id PAA36910; Wed, 25 Aug 1999 15:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id 8AB94151E2; Wed, 25 Aug 1999 15:48:36 -0700 (PDT) Message-Id: <19990825224836.8AB94151E2@hub.freebsd.org> Date: Wed, 25 Aug 1999 15:48:36 -0700 (PDT) From: ncalvo@es.freebsd.org To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/13384: Minor omission in the chapter 'Backups' of the Handbook Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13384 >Category: docs >Synopsis: Minor omission in the chapter 'Backups' of the Handbook >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: Wed Aug 25 15:50:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Nestor Calvo >Release: 3.2-STABLE >Organization: >Environment: FreeBSD myname.my.domain 3.2-RELEASE FreeBSD 3.2-RELEASE #0: Tue May 18 04:05:08 GMT 1999 jkh@cathair:/usr/src/sys/compile/GENERIC i386 >Description: The SGML source file of the 'Backups' chapter of the Handbook is incomplete. It features a sample script for creating a bootable floppy. At the end of the script: ----- begin quote ----- # umount the floppy and inform the user # /sbin/umount /mnt ------ end quote ------ The floppy is unmounted, but the user is not informed. >How-To-Repeat: Not applicable (just read the file). >Fix: Issue a message to the user, e.g.: echo "The floppy has been unmounted and is now ready." >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Aug 25 17: 4:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 302E01538F; Wed, 25 Aug 1999 17:02:28 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18415.on.bellglobal.com (ppp18359.on.bellglobal.com [206.172.130.39]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id UAA19254; Wed, 25 Aug 1999 20:01:08 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id TAA39717; Wed, 25 Aug 1999 19:43:48 -0400 (EDT) (envelope-from tim) Date: Wed, 25 Aug 1999 19:43:48 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: Motoyuki Konno , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990825194348.G18970@ppp18415.on.bellglobal.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990825115510.A96398@kilt.nothing-going-on.org>; from Nik Clayton on Wed, Aug 25, 1999 at 11:55:10AM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 25, 1999 at 11:55:10AM +0100, Nik Clayton wrote: > > I think we must. There are two reasons for this; > > 1. It makes the file easier to follow. If the file is easier to follow > then it makes it easier to add new documentation, see the structure > of the document, and so on. Are you objecting to my suggestion with this? [If so, I intend to state why you are somewhat wrong ... otherwise, just carry on as usual. :-] -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 1: 8:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from enterprise.sanyusan.se (enterprise.sanyusan.se [195.24.160.51]) by hub.freebsd.org (Postfix) with ESMTP id 2F7C81539B for ; Thu, 26 Aug 1999 01:08:46 -0700 (PDT) (envelope-from anders@enterprise.sanyusan.se) Received: (from anders@localhost) by enterprise.sanyusan.se (8.9.3/8.9.3) id KAA33457 for freebsd-doc@FreeBSD.ORG; Thu, 26 Aug 1999 10:02:02 +0200 (CEST) (envelope-from anders) Date: Thu, 26 Aug 1999 10:02:01 +0200 From: Anders Andersson To: freebsd-doc@FreeBSD.ORG Subject: ndc(8) Message-ID: <19990826100201.A33426@enterprise.sanyusan.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre1i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I found that ndc(8) man page is a little wrong, for example 'stats Causes named to dump its statistics to /var/tmp/named.stats' is not correct, since named.stats get dumped to /etc/namedb/named.stats. It should read: 'stats Causes named to dump its statistics to /etc/namedb/named.stats' This also applies for /var/tmp/named_dump.db, that one goes also in /etc/namedb. I dont send diff's since I have no man page hacking experience. Anders -- Anders Andersson anders@sanyusan.se Sanyusan International AB http://www.sanyusan.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 2:47:41 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id CE35214F67 for ; Thu, 26 Aug 1999 02:45:18 -0700 (PDT) (envelope-from ph@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id MAA15584; Thu, 26 Aug 1999 12:43:47 +0400 (MSD) (envelope-from ph@scorpion.crimea.ua) Received: (from ph@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id MAA02365; Thu, 26 Aug 1999 12:34:57 +0400 (MSD) Message-Id: <199908260834.MAA02365@scorpion.crimea.ua> Subject: Re: ndc(8) In-Reply-To: <19990826100201.A33426@enterprise.sanyusan.se> from Anders Andersson at "Aug 26, 99 10:02:01 am" To: anders@sanyusan.se (Anders Andersson) Date: Thu, 26 Aug 1999 12:34:56 +0400 (MSD) Cc: freebsd-doc@FreeBSD.ORG From: "Alexey M. Zelkin" X-Mailer: ELM [version 2.4ME+ PL40 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > I found that ndc(8) man page is a little wrong, for example > > 'stats Causes named to dump its statistics to /var/tmp/named.stats' > > is not correct, since named.stats get dumped to /etc/namedb/named.stats. > > It should read: > > 'stats Causes named to dump its statistics to /etc/namedb/named.stats' > > This also applies for /var/tmp/named_dump.db, that one goes also in > /etc/namedb. Index: ndc.8 =================================================================== RCS file: /usr/local/CVSROOT/src/contrib/bind/doc/man/ndc.8,v retrieving revision 1.1.1.1 diff -c -r1.1.1.1 ndc.8 *** ndc.8 1998/05/03 04:11:36 1.1.1.1 --- ndc.8 1999/08/26 08:33:08 *************** *** 53,59 **** Causes .Ic @INDOT@named to dump its database and cache to ! .Pa /var/tmp/named_dump.db (uses the .Dv INT signal.) --- 53,59 ---- Causes .Ic @INDOT@named to dump its database and cache to ! .Pa /etc/namedb/named_dump.db (uses the .Dv INT signal.) *************** *** 68,74 **** Causes .Ic @INDOT@named to dump its statistics to ! .Pa /var/tmp/named.stats (uses the .Dv IOT or --- 68,74 ---- Causes .Ic @INDOT@named to dump its statistics to ! .Pa /etc/namedb/named.stats (uses the .Dv IOT or -- Sincerely Yours, Alexey Zelkin mailto:phantom@sunbay.com, ICQ: #6196584 Sunbay Software, Ltd. http://www.sunbay.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 3:21:34 1999 Delivered-To: freebsd-doc@freebsd.org Received: from martini.ics.es.osaka-u.ac.jp (martini.ics.es.osaka-u.ac.jp [133.1.12.150]) by hub.freebsd.org (Postfix) with ESMTP id C7DF914E31 for ; Thu, 26 Aug 1999 03:21:16 -0700 (PDT) (envelope-from matusita@matatabi.or.jp) Received: from localhost (localhost [127.0.0.1]) by martini.ics.es.osaka-u.ac.jp (8.9.3/3.7W/INO-1.0v8-SLAVE) with ESMTP id TAA91574 for ; Thu, 26 Aug 1999 19:21:11 +0900 (JST) X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94b51 XEmacs/21.2 (Toshima) X-SKK-Version: 10.49 X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) X-Fingerprint: 0C AC 93 FC E3 9D 9E 5B 3D B8 AC 5C 4A 79 D8 A6 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 990818(IM122) Lines: 13 From: Makoto MATSUSHITA (=?ISO-2022-JP?B?GyRCJF4kRCQ3JD8kXiQzJEgbKEI=?=) To: doc@freebsd.org Subject: Japanese FAQ on the Web is broken Date: Thu, 26 Aug 1999 19:21:09 +0900 Message-Id: <19990826192109K.matusita@matatabi.or.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Sorry if this is a well-known bug. , the entry page of FreeBSD FAQ written in Japanese is broken (all characters are not a japanese character!). Why? Who break? Is it a declaration of that FDP only supports laten-1 character set ? :-) I've checked and found that other pages are also broken; I doubt if it's a SERIOUS BUG of documentation producing procedure. It should be fixed. -- - Makoto `MAR' MATSUSHITA To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 3:44:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from gw01.firewall.cac.co.jp (gw01.cac.co.jp [160.240.112.11]) by hub.freebsd.org (Postfix) with ESMTP id 7455314FED for ; Thu, 26 Aug 1999 03:44:38 -0700 (PDT) (envelope-from koich@cac.co.jp) Received: from topaz.koraku.cac.co.jp ([160.240.184.57] (may be forged)) by gw01.firewall.cac.co.jp (8.8.6/3.6W99070314) with ESMTP id TAA17470 for ; Thu, 26 Aug 1999 19:40:40 +0900 (JST) Received: from cac.co.jp ([160.240.184.66]) by topaz.koraku.cac.co.jp (8.8.7/3.7W-99040822) with ESMTP id TAA13921; Thu, 26 Aug 1999 19:47:29 +0900 Message-ID: <37C51A0A.6BED6829@cac.co.jp> Date: Thu, 26 Aug 1999 19:42:18 +0900 From: Suzuki Koichi Organization: CAC Corporation X-Mailer: Mozilla 4.61 [ja_JP.EUC] (X11; I; FreeBSD 3.2-RELEASE i386) X-Accept-Language: ja, en MIME-Version: 1.0 To: doc@freebsd.org Subject: ja/FAQ/ is broken? Content-Type: text/plain; charset=iso-2022-jp Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, FreeBSD doc team. I'm Japanese FreeBSD User. I can't read Japanese FAQ Pages. http://www.FreeBSD.org/ja/FAQ/ Their seem to be encoded curiously. What's wrong? -- This is my STYLE. Suzuki Koichi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 4:33:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from TYO203.gate.nec.co.jp (TYO203.gate.nec.co.jp [202.32.8.211]) by hub.freebsd.org (Postfix) with ESMTP id 8019A14FCB for ; Thu, 26 Aug 1999 04:33:53 -0700 (PDT) (envelope-from y-koga@ccs.mt.nec.co.jp) Received: from mailsv.nec.co.jp ([192.168.1.90]) by TYO203.gate.nec.co.jp (8.9.3/3.7W99082313) with ESMTP id UAA11296 for ; Thu, 26 Aug 1999 20:33:53 +0900 (JST) Received: from gw.ccs.mt.nec.co.jp (gw.ccs.mt.nec.co.jp [133.201.4.2]) by mailsv.nec.co.jp (8.9.3/3.7W-MAILSV-NEC) with ESMTP id UAA27322 for ; Thu, 26 Aug 1999 20:33:52 +0900 (JST) Received: from mail.ccs.mt.nec.co.jp (mail.ccs.mt.nec.co.jp [133.201.3.22]) by gw.ccs.mt.nec.co.jp (8.9.1+3.1W/3.3W9-GW_CCS) with ESMTP id UAA23623 for ; Thu, 26 Aug 1999 20:33:52 +0900 (JST) Received: from splpe481.ccs.mt.nec.co.jp (splpe481.ccs.mt.nec.co.jp [172.16.5.66]) by mail.ccs.mt.nec.co.jp (8.9.1a/3.6W-CCS_Master) with ESMTP id UAA07580; Thu, 26 Aug 1999 20:33:50 +0900 (JST) Received: from localhost (localhost [127.0.0.1]) by splpe481.ccs.mt.nec.co.jp (8.9.3/3.7W-99071414) with ESMTP id UAA11204; Thu, 26 Aug 1999 20:33:50 +0900 (JST) Message-Id: <199908261133.UAA11204@splpe481.ccs.mt.nec.co.jp> To: freebsd-doc@FreeBSD.org Subject: Japanese FAQ pages are broken X-Mailer: Mew version 1.94b55 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Thu, 26 Aug 1999 20:33:49 +0900 (JST) From: Koga Youichirou X-Dispatcher: imput version 990826(IM126) Lines: 14 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Dear FAQ maintainers, I found that Japanese FAQ pages are broken (other Japanese pages, e.g. handbook, are not broken). There all KANJI characters are encoded strangely. I'm afraid that many browsers can not show them, and probably some (many?) indexers don't handle them. Check pages and correct them, please. Sincerely, -- Koga, Youichirou To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 4:41:33 1999 Delivered-To: freebsd-doc@freebsd.org Received: from ns.sanda.gr.jp (ns.sanda.gr.jp [210.232.122.18]) by hub.freebsd.org (Postfix) with ESMTP id BD06314E94 for ; Thu, 26 Aug 1999 04:41:26 -0700 (PDT) (envelope-from non@ever.sanda.gr.jp) Received: from ever.sanda.gr.jp (epoch [10.93.63.51]) by ns.sanda.gr.jp (8.8.8/3.6W) with ESMTP id UAA23671 for ; Thu, 26 Aug 1999 20:41:23 +0900 From: non@ever.sanda.gr.jp Received: from localhost (localhost [127.0.0.1]) by ever.sanda.gr.jp (8.8.8/3.3W9) with ESMTP id UAA13299 for ; Thu, 26 Aug 1999 20:41:23 +0900 (JST) To: doc@freebsd.org Subject: www.FreeBSD.org/ja/FAQ X-Mailer: Mew version 1.93 on Emacs 19.28 / Mule 2.3 =?iso-2022-jp?B?KBskQkt2RSYyVhsoQik=?= Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-Id: <19990826204122Y.non@ever.sanda.gr.jp> Date: Thu, 26 Aug 1999 20:41:22 +0900 X-Dispatcher: imput version 980905(IM100) Lines: 6 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org It seems that Japanese version of FAQ http://www.FreeBSD.org/ja/FAQ/ is broken. Is anything wrong ? Regards, Noriaki Mitsunaga To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 5: 1: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from enterprise.sanyusan.se (enterprise.sanyusan.se [195.24.160.51]) by hub.freebsd.org (Postfix) with ESMTP id 8120515A14 for ; Thu, 26 Aug 1999 05:01:04 -0700 (PDT) (envelope-from anders@enterprise.sanyusan.se) Received: (from anders@localhost) by enterprise.sanyusan.se (8.9.3/8.9.3) id NAA44984; Thu, 26 Aug 1999 13:56:51 +0200 (CEST) (envelope-from anders) Date: Thu, 26 Aug 1999 13:56:50 +0200 From: Anders Andersson To: "Alexey M. Zelkin" Cc: freebsd-doc@FreeBSD.ORG Subject: Re: ndc(8) Message-ID: <19990826135650.A44944@enterprise.sanyusan.se> References: <19990826100201.A33426@enterprise.sanyusan.se> <199908260834.MAA02365@scorpion.crimea.ua> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="UugvWAfsgieZRqgk" X-Mailer: Mutt 1.0pre1i In-Reply-To: <199908260834.MAA02365@scorpion.crimea.ua> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --UugvWAfsgieZRqgk Content-Type: text/plain; charset=us-ascii Making a complete patch was easier then I thought. This fixes the whole ndc(8) man page. Should I send-pr this? Anders -- Anders Andersson anders@sanyusan.se Sanyusan International AB http://www.sanyusan.se/ --UugvWAfsgieZRqgk Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="ndc.8.diff" --- /usr/src/contrib/bind/doc/man/ndc.8 Sun May 3 06:11:36 1998 +++ ndc.8 Thu Aug 26 13:50:26 1999 @@ -53,7 +53,7 @@ Causes .Ic @INDOT@named to dump its database and cache to -.Pa /var/tmp/named_dump.db +.Pa /etc/namedb/named_dump.db (uses the .Dv INT signal.) @@ -68,7 +68,7 @@ Causes .Ic @INDOT@named to dump its statistics to -.Pa /var/tmp/named.stats +.Pa /etc/namedb/named.stats (uses the .Dv IOT or @@ -81,7 +81,7 @@ .Dq tracing level by one. Whenever the tracing level is nonzero, trace information will be written to -.Pa /var/tmp/named.run . +.Pa /etc/namedb/named.run . Higher tracing levels result in more detailed information. (Uses the .Dv USR1 @@ -92,7 +92,7 @@ to set its .Dq tracing level to zero, closing -.Pa /var/tmp/named.run , +.Pa /etc/namedb/named.run , if it is open (uses the .Dv USR2 signal.) --UugvWAfsgieZRqgk-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 7: 3:23 1999 Delivered-To: freebsd-doc@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6]) by hub.freebsd.org (Postfix) with ESMTP id 1129914E4A for ; Thu, 26 Aug 1999 07:03:21 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 3CC2D1C38; Thu, 26 Aug 1999 09:06:28 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by jade.chc-chimes.com (Postfix) with ESMTP id 390B33815; Thu, 26 Aug 1999 09:06:28 -0400 (EDT) Date: Thu, 26 Aug 1999 09:06:28 -0400 (EDT) From: Bill Fumerola To: Makoto MATSUSHITA Cc: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken In-Reply-To: <19990826192109K.matusita@matatabi.or.jp> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, 26 Aug 1999, Makoto MATSUSHITA wrote: > japanese character!). Why? Who break? Is it a declaration of that FDP > only supports laten-1 character set ? :-) This mudslinging shit has got to stop. I am so sick of every post coming from *.jp containing some sort of dig, jab, or poke about "declarations", "proclamations", "dictatorships", "directives", and other similar words. Nik has done more for the documentation project as a whole in the past month then years of 'this would be nice' has come up with, and if he happened to forget to examine some parts of his massive reorginization, then you(collectivly) will have to realize that this is a volunteer project and this is for the greater good of the project. He obviously is not trying to remove the valuable .jp translations, and the sooner this mailing list realizes that the better. Instead of bitching about the problem I'd encourage you to focus that negative energy into figuring out just where the problem is occuring and actually send a patch. -- - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:18:10 1999 Delivered-To: freebsd-doc@freebsd.org Received: from martini.ics.es.osaka-u.ac.jp (martini.ics.es.osaka-u.ac.jp [133.1.12.150]) by hub.freebsd.org (Postfix) with ESMTP id 2F36315C13 for ; Thu, 26 Aug 1999 08:17:55 -0700 (PDT) (envelope-from matusita@matatabi.or.jp) Received: from localhost (localhost [127.0.0.1]) by martini.ics.es.osaka-u.ac.jp (8.9.3/3.7W/INO-1.0v8-SLAVE) with ESMTP id AAA92488 for ; Fri, 27 Aug 1999 00:15:57 +0900 (JST) In-Reply-To: References: <19990826192109K.matusita@matatabi.or.jp> X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94b51 XEmacs/21.2 (Toshima) X-SKK-Version: 10.49 X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) X-Fingerprint: 0C AC 93 FC E3 9D 9E 5B 3D B8 AC 5C 4A 79 D8 A6 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 990818(IM122) Lines: 21 From: Makoto MATSUSHITA (=?ISO-2022-JP?B?GyRCJF4kRCQ3JD8kXiQzJEgbKEI=?=) To: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken Date: Fri, 27 Aug 1999 00:15:54 +0900 Message-Id: <19990827001554V.matusita@matatabi.or.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org billf> Instead of bitching about the problem I'd encourage you to billf> focus that negative energy into figuring out just where the billf> problem is occuring and actually send a patch. Negative energy? Pointing out a mistake is a NEGATIVE ENERGY? You say that all bug-reports are only for NEGATIVE ENERGY? Are you kidding me ?:-) Yes, sending a patch is maybe the best way to fix, but if these changes are caused by someone's special hacks, it is difficult to do. There are no branching in documentation area, however, we should know that this does not means that documentations are always '-current' status; it should be always '-stable' status (this is why documentation is very important and difficult activity of FreeBSD, isn't it?). I'm very sad that why we cannot not avoid current situation. Miss-character-conversion may be checked EASILY BEFORE commiting the results. -- - Makoto `MAR' MATSUSHITA To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:20:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from po.jah.ne.jp (cosmo.jah.ne.jp [210.162.2.2]) by hub.freebsd.org (Postfix) with ESMTP id B5CD915360 for ; Thu, 26 Aug 1999 08:20:40 -0700 (PDT) (envelope-from oresamachan@mtf.biglobe.ne.jp) Received: from radon (dp2084.jah.ne.jp [210.162.3.84]) by po.jah.ne.jp (8.9.3+3.2W/3.7Wpl2-smtpcheck2/jahgw99071912) with SMTP id AAA03904 for ; Fri, 27 Aug 1999 00:20:38 +0900 (JST) (envelope-from oresamachan@mtf.biglobe.ne.jp) Date: Fri, 27 Aug 1999 00:21:43 +0900 From: Oresamachan To: doc@freebsd.org Subject: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: References: <19990826192109K.matusita@matatabi.or.jp> Message-Id: <37C55B87366.4882ORESAMACHAN@cosmo.jah.ne.jp> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Mailer: Becky! ver 1.25.07 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Bill, > > japanese character!). Why? Who break? Is it a declaration of that FDP > > only supports laten-1 character set ? :-) > > This mudslinging shit has got to stop. I am so sick of every post coming > from *.jp containing some sort of dig, jab, or poke about "declarations", > "proclamations", "dictatorships", "directives", and other similar words. No, I absolutely can not agree with you. I believe nobody never respect Nik, but the what he did is not correct. That's it. TER Software Develop (e-mail: oresamachan@mtf.biglobe.ne.jp) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:39:42 1999 Delivered-To: freebsd-doc@freebsd.org Received: from ender.ncsa.es (ender.ncsa.es [194.179.50.15]) by hub.freebsd.org (Postfix) with ESMTP id 46E5F14DF2 for ; Thu, 26 Aug 1999 08:39:35 -0700 (PDT) (envelope-from jesusr@ncsa.es) Received: from ender.ncsa.es (localhost [127.0.0.1]) by ender.ncsa.es (8.9.3/8.9.3) with ESMTP id RAA05921; Thu, 26 Aug 1999 17:41:35 +0200 (CEST) (envelope-from jesusr@ncsa.es) Message-ID: X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <37C55B87366.4882ORESAMACHAN@cosmo.jah.ne.jp> Date: Thu, 26 Aug 1999 17:41:34 +0200 (CEST) Reply-To: jesusr@ncsa.es Organization: Nexus Comunicaciones, S.A. From: Jesus Rodriguez To: Oresamachan Subject: RE: Re[2]: Japanese FAQ on the Web is broken Cc: doc@FreeBSD.ORG Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 26-Aug-99 Oresamachan wrote: > Bill, > >> > japanese character!). Why? Who break? Is it a declaration of that FDP >> > only supports laten-1 character set ? :-) >> >> This mudslinging shit has got to stop. I am so sick of every post coming >> from *.jp containing some sort of dig, jab, or poke about "declarations", >> "proclamations", "dictatorships", "directives", and other similar words. > > No, I absolutely can not agree with you. > I believe nobody never respect Nik, but the what he did is not correct. > That's it. Why don't respect Nik? Like Bill says, Nik has done a *lot* of job on doc/ and he is trying to make things better / better things. I don't really know why japanese people always have problems with *any* change or modification on doc/. It's so difficult? About last threads, i would like to say that become *-meister doesn't mean become Superman and living over everybody. Nik is doc-meister and he has the *last* word, but this doesn't mean that he can't comment things with -doc people and discuss the changes, updates, modifications, etc on doc/. Saludos JesusR. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:40:46 1999 Delivered-To: freebsd-doc@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6]) by hub.freebsd.org (Postfix) with ESMTP id 1BEC914DF2 for ; Thu, 26 Aug 1999 08:40:44 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id C89ED1C2E; Thu, 26 Aug 1999 10:43:50 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by jade.chc-chimes.com (Postfix) with ESMTP id C38073815; Thu, 26 Aug 1999 10:43:50 -0400 (EDT) Date: Thu, 26 Aug 1999 10:43:50 -0400 (EDT) From: Bill Fumerola To: Makoto MATSUSHITA Cc: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken In-Reply-To: <19990827001554V.matusita@matatabi.or.jp> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Makoto MATSUSHITA wrote: > Negative energy? Pointing out a mistake is a NEGATIVE ENERGY? You say > that all bug-reports are only for NEGATIVE ENERGY? Are you kidding me ?:-) >> japanese character!). Why? Who break? Is it a declaration of that FDP >> only supports laten-1 character set ? :-) That is negative energy, when every broken part of the tree is an accusation of some sort of scheme by Nik to alienate the JP translation team. > Yes, sending a patch is maybe the best way to fix, but if these > changes are caused by someone's special hacks, it is difficult to do. > There are no branching in documentation area, however, we should know > that this does not means that documentations are always '-current' > status; it should be always '-stable' status (this is why documentation > is very important and difficult activity of FreeBSD, isn't it?). I can take a look at the tree whenever I want to just like you can http://www.FreeBSD.org/cgi/cvsweb.cgi/ -- - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:41:26 1999 Delivered-To: freebsd-doc@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6]) by hub.freebsd.org (Postfix) with ESMTP id 0473815B8D for ; Thu, 26 Aug 1999 08:41:24 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 78CF51C2E; Thu, 26 Aug 1999 10:44:29 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by jade.chc-chimes.com (Postfix) with ESMTP id 743733815; Thu, 26 Aug 1999 10:44:29 -0400 (EDT) Date: Thu, 26 Aug 1999 10:44:29 -0400 (EDT) From: Bill Fumerola To: Oresamachan Cc: doc@freebsd.org Subject: Re: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: <37C55B87366.4882ORESAMACHAN@cosmo.jah.ne.jp> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Oresamachan wrote: > No, I absolutely can not agree with you. > I believe nobody never respect Nik, but the what he did is not correct. > That's it. I can't even read this to comment. -- - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:52:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from po.jah.ne.jp (cosmo.jah.ne.jp [210.162.2.2]) by hub.freebsd.org (Postfix) with ESMTP id 78E3314D09 for ; Thu, 26 Aug 1999 08:52:00 -0700 (PDT) (envelope-from oresamachan@mtf.biglobe.ne.jp) Received: from radon (dp2084.jah.ne.jp [210.162.3.84]) by po.jah.ne.jp (8.9.3+3.2W/3.7Wpl2-smtpcheck2/jahgw99071912) with SMTP id AAA26864 for ; Fri, 27 Aug 1999 00:51:48 +0900 (JST) (envelope-from oresamachan@mtf.biglobe.ne.jp) Date: Fri, 27 Aug 1999 00:52:53 +0900 From: Oresamachan To: doc@freebsd.org Subject: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: <19990827001554V.matusita@matatabi.or.jp> References: <19990827001554V.matusita@matatabi.or.jp> Message-Id: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Mailer: Becky! ver 1.25.07 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Matsushita-san, Check your "From:" :-) > I'm very sad that why we cannot not avoid current > situation. Miss-character-conversion may be checked EASILY BEFORE > commiting the results. Everybody makes mistake. According to my experience, non-asian user does not understand "encoding systems" easily. That is not so big fault if that is corrected immediately. The problem is Bill's ridiculous posting. Does he understand the problem is serious? Some industrious man developed a program. Unfortunately, there was a serious bug on it and a user pointed out. Is this a negative energy??? Maybe Bill is sleeping right now. At least, I hope so. TER Software Develop (e-mail: oresamachan@mtf.biglobe.ne.jp) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 8:59:49 1999 Delivered-To: freebsd-doc@freebsd.org Received: from martini.ics.es.osaka-u.ac.jp (martini.ics.es.osaka-u.ac.jp [133.1.12.150]) by hub.freebsd.org (Postfix) with ESMTP id A27F9150C1 for ; Thu, 26 Aug 1999 08:59:42 -0700 (PDT) (envelope-from matusita@matatabi.or.jp) Received: from localhost (localhost [127.0.0.1]) by martini.ics.es.osaka-u.ac.jp (8.9.3/3.7W/INO-1.0v8-SLAVE) with ESMTP id AAA92745 for ; Fri, 27 Aug 1999 00:57:29 +0900 (JST) In-Reply-To: References: <19990827001554V.matusita@matatabi.or.jp> X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94b51 XEmacs/21.2 (Toshima) X-SKK-Version: 10.49 X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) X-Fingerprint: 0C AC 93 FC E3 9D 9E 5B 3D B8 AC 5C 4A 79 D8 A6 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 990818(IM122) Lines: 15 From: Makoto MATSUSHITA (=?ISO-2022-JP?B?GyRCJF4kRCQ3JD8kXiQzJEgbKEI=?=) To: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken Date: Fri, 27 Aug 1999 00:57:27 +0900 Message-Id: <19990827005727L.matusita@matatabi.or.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org First of all, I'm not a member of JP translation team. I'm just a novice FreeBSD user and want to read a Japanese FAQ ASAP. billf> That is negative energy, when every broken part of the tree is billf> an accusation of some sort of scheme by Nik to alienate the JP billf> translation team. I dunno about Nik, but if he/she do so, the first person who emerges the 'negative energy' to the relationship between Nik and JP translation team is... I think that is Nik oneself, not me (I'm only the man who pointed out that there is a negative energy in documents). -- - Makoto `MAR' MATSUSHITA To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 9: 6:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id C540215C3A for ; Thu, 26 Aug 1999 09:06:31 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 77819 invoked by uid 1003); 26 Aug 1999 16:05:57 -0000 Date: Thu, 26 Aug 1999 18:05:57 +0200 From: Neil Blakey-Milner To: Oresamachan Cc: doc@FreeBSD.ORG Subject: Re: Japanese FAQ on the Web is broken Message-ID: <19990826180557.A75341@rucus.ru.ac.za> References: <19990827001554V.matusita@matatabi.or.jp> <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp>; from Oresamachan on Fri, Aug 27, 1999 at 12:52:53AM +0900 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri 1999-08-27 (00:52), Oresamachan wrote: > > I'm very sad that why we cannot not avoid current > > situation. Miss-character-conversion may be checked EASILY BEFORE > > commiting the results. > > Everybody makes mistake. > According to my experience, non-asian user does not understand "encoding > systems" easily. > That is not so big fault if that is corrected immediately. Speaking as someone who speaks and reads only languages which use "standard" encoding (or those which have been forced to assume that encoding), I must admit I'd have problems distinguishing encoding systems. I think the real question is when this mistake occurred, and what caused it, and what we must do to fix it. > The problem is Bill's ridiculous posting. > Does he understand the problem is serious? I think he does. I believe it may be because all of a sudden, in a row, there were 4 mails from Japanese users complaining about the FAQ encoding. I definately began to wonder whether this was perhaps organized by the Japanese section of the FDP to show support. Whilst this may sound insane, and I indeed checked myself, we have conflicting egos on projects like this, and this isn't the first or last time something is organized, and some people are reactionary. There is often perceived apathy, hatred, dislike, or other negative attitudes, usually due to miscommunication (and I don't mean due to language barriers necessarily). For example, for some reason, at the moment there is a perception that the Japanese section don't like Nik. I doubt this is necessarily true. I perceieve there is a perception amongst some that Nik is apathetic towards translations, or does things without asking people. I utterly doubt this is the case. In the mean time, can someone who understands encodings take a look at what caused the problem, when it originated, who we must reprimand and send out to buy us all cooldrink, and how to fix the problem? We don't need infighting. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 9:11:37 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 9741F150C1 for ; Thu, 26 Aug 1999 09:11:30 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 78783 invoked by uid 1003); 26 Aug 1999 16:09:51 -0000 Date: Thu, 26 Aug 1999 18:09:51 +0200 From: Neil Blakey-Milner To: Makoto MATSUSHITA Cc: doc@FreeBSD.ORG Subject: Re: Japanese FAQ on the Web is broken Message-ID: <19990826180951.B75341@rucus.ru.ac.za> References: <19990827001554V.matusita@matatabi.or.jp> <19990827005727L.matusita@matatabi.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <19990827005727L.matusita@matatabi.or.jp>; from Makoto MATSUSHITA on Fri, Aug 27, 1999 at 12:57:27AM +0900 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri 1999-08-27 (00:57), Makoto MATSUSHITA wrote: > First of all, I'm not a member of JP translation team. I'm just a > novice FreeBSD user and want to read a Japanese FAQ ASAP. Sorry to involve you in this unnecessary argument. > billf> That is negative energy, when every broken part of the tree is > billf> an accusation of some sort of scheme by Nik to alienate the JP > billf> translation team. > > I dunno about Nik, but if he/she do so, the first person who emerges > the 'negative energy' to the relationship between Nik and JP > translation team is... I think that is Nik oneself, not me (I'm only > the man who pointed out that there is a negative energy in documents). I think you mean to say that it is not you who is causing the problem, and that the negative energy, if any, in the relationship doesn't involve you. After all, you don't want to be perceived in siding with the JP translation team automatically against Nik in a situation you're not involved in. We do hope to resolve the encoding problem soon, and I'll be sure to send you mail when it works again. May I suggest you check other web mirrors - they may have earlier copies of these documents. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 9:19:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from quackerjack.cc.vt.edu (quackerjack.cc.vt.edu [198.82.160.250]) by hub.freebsd.org (Postfix) with ESMTP id 500D815C6D for ; Thu, 26 Aug 1999 09:19:31 -0700 (PDT) (envelope-from jobaldwi@vt.edu) Received: from sable.cc.vt.edu (sable.cc.vt.edu [128.173.16.30]) by quackerjack.cc.vt.edu (8.8.8/8.8.8) with ESMTP id MAB05249; Thu, 26 Aug 1999 12:18:12 -0400 (EDT) Received: from john.baldwin.cx (hC6524392.dhcp.vt.edu [198.82.67.146]) by sable.cc.vt.edu (8.8.8/8.8.8) with ESMTP id MAA09188; Thu, 26 Aug 1999 12:18:12 -0400 (EDT) Message-Id: <199908261618.MAA09188@sable.cc.vt.edu> X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> Date: Thu, 26 Aug 1999 12:18:22 -0400 (EDT) From: John Baldwin To: Oresamachan Subject: RE: Re[2]: Japanese FAQ on the Web is broken Cc: doc@freebsd.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 26-Aug-99 Oresamachan wrote: > Matsushita-san, > > Check your "From:" :-) > >> I'm very sad that why we cannot not avoid current >> situation. Miss-character-conversion may be checked EASILY BEFORE >> commiting the results. > > Everybody makes mistake. > According to my experience, non-asian user does not understand "encoding > systems" easily. > That is not so big fault if that is corrected immediately. > > The problem is Bill's ridiculous posting. > Does he understand the problem is serious? > > Some industrious man developed a program. > Unfortunately, there was a serious bug on it and a user pointed out. > > Is this a negative energy??? > Maybe Bill is sleeping right now. At least, I hope so. > > TER Software Develop > (e-mail: oresamachan@mtf.biglobe.ne.jp) Here is the problem I think Bill was getting at. Nik's plan for the doc/ reorganization was thrashed out on this list months ago, and he and several others have worked very hard to implement it. Now, he's only human, and its not going to be 100% perfect the first time around. However, if you read the archives for -doc/ you will notice that almost every time somebody started griping and complaining about a glitch or a proposed claim, it was the Japanese team that was jumping up and down while all the other translations worked to make the change. The notable exception to this was the recent /usr/local/share/doc/fdp vs. /usr/share/doc issue. That is the problem: the French group hasn't been yelling or jumping up and down about this transition, neither has the Spanish group or the Russian group. Instead, they have accepted the few bumps in the road and worked through them. On the other hand, from what we can see on the -doc list the Japanese team does not follow this. Is it any suprise many of us are tired of seeing complaints from *.jp? The documentation doesn't revolve around English, Spanish, or any other language, including Japanese. There are going to be little problems here and there, but the proper response at this point in time is to suck it up and see if you can fix it. Once you do, submit a PR, don't just gripe to this list. Note that many of us cannot read Japanese, so we don't know it's necessarily broken, nor are we in a good place to fix it. This is a volunteer project and its your turn to contribute! --- John Baldwin -- http://members.freedomnet.com/~jbaldwin/ PGP Key: http://members.freedomnet.com/~jbaldwin/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.freebsd.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 9:27:54 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mail.kt.rim.or.jp (mail.kt.rim.or.jp [202.247.130.53]) by hub.freebsd.org (Postfix) with ESMTP id 60FA215CE3 for ; Thu, 26 Aug 1999 09:27:38 -0700 (PDT) (envelope-from kuriyama@sky.rim.or.jp) Received: from rhea.sky.rim.or.jp (ppp374.kt.rim.or.jp [202.247.140.74]) by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id BAA29452 for ; Fri, 27 Aug 1999 01:27:31 +0900 (JST) Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1]) by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id BAA64726; Fri, 27 Aug 1999 01:27:29 +0900 (JST) Date: Fri, 27 Aug 1999 01:19:29 +0900 Message-ID: <14277.26897.547628.68187Y@localhost.sky.rim.or.jp> From: Jun Kuriyama To: freebsd-doc@freebsd.org Subject: Japanese FAQ on www.freebsd.org is broken User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd) Cc: Jun Kuriyama MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Currently, Japanese FAQ is fully broken. I fixed this by adding two variable into Makefile but make cannot find this modification so build for www.freebsd.org is not updated. I've mailed this to wosch and nik, who should I report this problem to fix as soon as possible? To solve this problem, build www.freebsd.org contents from scratch, or "make clean" in doc/ja_JP.eucJP/books/faq before building. Jun Kuriyama // kuriyama@sky.rim.or.jp // kuriyama@FreeBSD.ORG To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 9:47: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6]) by hub.freebsd.org (Postfix) with ESMTP id 89BAD15D8F for ; Thu, 26 Aug 1999 09:47:00 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 7F2AA1C2E; Thu, 26 Aug 1999 11:50:06 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by jade.chc-chimes.com (Postfix) with ESMTP id 7AA7C3815; Thu, 26 Aug 1999 11:50:06 -0400 (EDT) Date: Thu, 26 Aug 1999 11:50:06 -0400 (EDT) From: Bill Fumerola To: Oresamachan Cc: doc@freebsd.org Subject: Re: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Oresamachan wrote: > The problem is Bill's ridiculous posting. > Does he understand the problem is serious? The problem is that Bill actually takes the greater good of the project to heart, not some crazy-ass conspiracy theory. > Some industrious man developed a program. > Unfortunately, there was a serious bug on it and a user pointed out. I'm sure you've never made a mistake. > Is this a negative energy??? The negative energy would be the energy spent bitching. Most of us got our commit privledges because instead of bitching we provided patches. > Maybe Bill is sleeping right now. At least, I hope so. No. -- - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 10:18:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from po.jah.ne.jp (cosmo.jah.ne.jp [210.162.2.2]) by hub.freebsd.org (Postfix) with ESMTP id 6E32714C04 for ; Thu, 26 Aug 1999 10:18:52 -0700 (PDT) (envelope-from oresamachan@mtf.biglobe.ne.jp) Received: from radon (dp2084.jah.ne.jp [210.162.3.84]) by po.jah.ne.jp (8.9.3+3.2W/3.7Wpl2-smtpcheck2/jahgw99071912) with SMTP id CAA26357; Fri, 27 Aug 1999 02:18:47 +0900 (JST) (envelope-from oresamachan@mtf.biglobe.ne.jp) Date: Fri, 27 Aug 1999 02:19:52 +0900 From: Oresamachan To: Bill Fumerola Cc: doc@freebsd.org Subject: Re[2]: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: References: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> Message-Id: <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Mailer: Becky! ver 1.25.07 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, 26 Aug 1999 11:50:06 -0400 (EDT) Bill Fumerola wrote: > On Fri, 27 Aug 1999, Oresamachan wrote: > > > The problem is Bill's ridiculous posting. > > Does he understand the problem is serious? > > The problem is that Bill actually takes the greater good of the project > to heart, not some crazy-ass conspiracy theory. Are you pushing through some crazy-ass conspiracy theory? > > > Some industrious man developed a program. > > Unfortunately, there was a serious bug on it and a user pointed out. > > I'm sure you've never made a mistake. > I do. But I always trying to correct them unlike you. > > Is this a negative energy??? > > The negative energy would be the energy spent bitching. Most of us got > our commit privledges because instead of bitching we provided patches. > I think you spent so much energy to bitch about the proposition. I don't know why you have so much compaints against improving the FreeBSD website. > > Maybe Bill is sleeping right now. At least, I hope so. > > No. > I believe he said "No." in his sleep. - Oresamachan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 10:43:43 1999 Delivered-To: freebsd-doc@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6]) by hub.freebsd.org (Postfix) with ESMTP id C12C0150D9 for ; Thu, 26 Aug 1999 10:43:38 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 93FBF1C37; Thu, 26 Aug 1999 12:45:55 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by jade.chc-chimes.com (Postfix) with ESMTP id 8F4693815; Thu, 26 Aug 1999 12:45:55 -0400 (EDT) Date: Thu, 26 Aug 1999 12:45:55 -0400 (EDT) From: Bill Fumerola To: Oresamachan Cc: doc@freebsd.org Subject: Re: Re[2]: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Oresamachan wrote: > Are you pushing through some crazy-ass conspiracy theory? Yes. East Asia v. Nik, film at 11. > I do. But I always trying to correct them unlike you. I didn't break anything. You're obviously clued in on this discussion. > I think you spent so much energy to bitch about the proposition. > I don't know why you have so much compaints against improving the > FreeBSD website. Show me in this thread where I said "don't fix this" or "don't improve this." I was merely observing that we got hit with a tsunami of complaint reports none of which offered a solution. > > No. > > I believe he said "No." in his sleep. I can't see this message, my eyes are closed. Grow up. -- - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 10:45:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from tasogare.imasy.or.jp (tasogare.imasy.or.jp [202.227.24.5]) by hub.freebsd.org (Postfix) with ESMTP id 02B9615D52 for ; Thu, 26 Aug 1999 10:45:10 -0700 (PDT) (envelope-from iwasaki@jp.FreeBSD.org) Received: from localhost (isdn15.imasy.or.jp [202.227.24.207]) by tasogare.imasy.or.jp (8.9.3+3.2W/3.7W-tasogare/smtpfeed 1.01) with ESMTP id CAA15930; Fri, 27 Aug 1999 02:44:45 +0900 (JST) (envelope-from iwasaki@jp.FreeBSD.org) Message-Id: <199908261744.CAA15930@tasogare.imasy.or.jp> To: oresamachan@mtf.biglobe.ne.jp Cc: billf@jade.chc-chimes.com, doc@freebsd.org Subject: Re: Re[2]: Re[2]: Japanese FAQ on the Web is broken In-Reply-To: Your message of "Fri, 27 Aug 1999 02:19:52 +0900" <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> References: <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> X-Mailer: Mew version 1.93 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Fri, 27 Aug 1999 02:48:10 +0900 From: Mitsuru IWASAKI X-Dispatcher: imput version 980905(IM100) Lines: 9 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, It seems that the problem was already analyzed by Kuriyama-san, hopefully this will be solved within a few days... I don't see any reason to fight here anymore. Could you continue exchanging mail personally if you want, not in public? BTW, when is the doc code freeze for 3.3-RELEASE? What can we do before that? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 10:50:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mta4.rcsntx.swbell.net (mta4.rcsntx.swbell.net [151.164.30.28]) by hub.freebsd.org (Postfix) with ESMTP id 64AD615D18 for ; Thu, 26 Aug 1999 10:50:12 -0700 (PDT) (envelope-from chris@holly.dyndns.org) Received: from holly.dyndns.org (adsl-216-62-154-215.dsl.hstntx.swbell.net) by mta4.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.1999.05.24.18.28.p7) with ESMTP id <0FH3000Z01SDRH@mta4.rcsntx.swbell.net> for doc@FreeBSD.ORG; Thu, 26 Aug 1999 12:26:37 -0500 (CDT) Received: (from chris@localhost) by holly.dyndns.org (8.9.3/8.9.3) id MAA16598; Thu, 26 Aug 1999 12:28:38 -0500 (CDT envelope-from chris) Date: Thu, 26 Aug 1999 12:28:36 -0500 From: Chris Costello Subject: Re: Re[2]: Japanese FAQ on the Web is broken In-reply-to: <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> To: Oresamachan Cc: Bill Fumerola , doc@FreeBSD.ORG Reply-To: chris@calldei.com Message-id: <19990826122836.E13759@holly.dyndns.org> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.4i References: <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Aug 27, 1999, Oresamachan wrote: > > I'm sure you've never made a mistake. > I do. But I always trying to correct them unlike you. Could we stop this petty fighting right now? If you want to seriously report this problem, use send-pr(1) and describe the problem, and if possible, supply us with a patch that would fix this problem. Your efforts will be appreciated. Thank you. -- |Chris Costello |Revolutionary: The disk drives go round and round. `-------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 11: 4:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp.hccnet.nl (smtp.hccnet.nl [193.172.127.93]) by hub.freebsd.org (Postfix) with ESMTP id 92C2115DB1 for ; Thu, 26 Aug 1999 11:04:17 -0700 (PDT) (envelope-from dja.de.kok@hccnet.nl) Received: from tazzy by smtp.hccnet.nl via uds172-118.dial.hccnet.nl [193.173.118.172] with SMTP for id UAA00991 (8.8.5/1.11); Thu, 26 Aug 1999 20:03:50 +0200 (MET DST) Message-ID: <000501beefed$a5436e60$0190fea9@tazzy> From: "=?iso-8859-1?Q?Dani=EBl_de_Kok?=" To: Subject: Dutch documentation Date: Thu, 26 Aug 1999 17:01:08 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 8bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 4.72.3110.1 X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3110.3 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, Is there anybody working on Dutch documentation for FreeBSD? I think FreeBSD is a great project, and I really would like to contribute to it... With best regards, Daniël de Kok To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 11:50:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 959C91517F for ; Thu, 26 Aug 1999 11:48:40 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA83049; Thu, 26 Aug 1999 19:38:23 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id LAA67385; Thu, 26 Aug 1999 11:01:58 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Thu, 26 Aug 1999 11:01:58 +0100 From: Nik Clayton To: Jim Mock Cc: doc@FreeBSD.org Subject: Re: http://www.freebsd.org/support.html#user Message-ID: <19990826110158.B66300@kilt.nothing-going-on.org> References: <19990826081309.A65454@blues.ghis.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990826081309.A65454@blues.ghis.net>; from Jim Mock on Thu, Aug 26, 1999 at 08:13:09AM +1000 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 08:13:09AM +1000, Jim Mock wrote: > I recall this being brought up before, but since it hasn't been done > yet I figured I'd bring it up again. Does anyone have any objections > to changing the location name of the user group listing to some other > color (preferably bold black)? As was mentioned the last time this > topic was brought up, most people associate blue with links. I also > think something bold would stand out a little better. Go for it. > If no one objects, I'll go through support.sgml and make and commit > the changes. I would like to hear other opinions on what color > everyone thinks they should be before I do it though. I'd make them bold, but leave the colour alone (i.e., rip out all the ... stuff, instead of putting in a different colour). N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 11:52: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id A44FA1517F for ; Thu, 26 Aug 1999 11:48:40 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA83050; Thu, 26 Aug 1999 19:38:23 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA02377; Thu, 26 Aug 1999 16:57:05 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Thu, 26 Aug 1999 16:57:04 +0100 From: Nik Clayton To: techwriters@linuxchix.org Cc: doc@freebsd.org Subject: Re: [oswg] Some thoughts on the Linux Documentation Project Message-ID: <19990826165704.A95099@kilt.nothing-going-on.org> Reply-To: techwriters@linuxchix.org References: <87btbvqxh8.fsf@tninkpad.telent.net> <99082519450307.00578@joplin> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <99082519450307.00578@joplin>; from David Rugge on Wed, Aug 25, 1999 at 07:30:13PM -0400 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi guys, [ I've cc'd the doc@FreeBSD.org mailing list this on this, but put replies back to the OSWG mailing list -- I'd like the FDP to have the opportunity to comment on this if there's anything I've missed. For the FDP: The context of this message is the apparent crisis at the LDP, and what to do about it. One of the things that's been discussed is the infrastructure you need in place to support a documentation project, and I thought I'd share some of the technical bits and pieces we've picked up over the last 12 months or so. ] On Wed, Aug 25, 1999 at 07:30:13PM -0400, David Rugge wrote: > There is a DocBook crash course at this site. I would also recommend > the FreeBSD Documentation tutorial which has a section on DocBook. > > http://www.freebsd.org/tutorials/docproj-primer/book.html Cheers. It's good to know that people are finding it useful. > I also wanted to comment on the suggested scheme for automating > corrections and updates to documentation. If an email bot is used to > update documentation then how do we check to make sure that the changes > are useful and worthwhile before they get committed? If an editor needs > to do this work then aren't we back to the same problems as with having > a documentation maintainer? Perhaps there could be a weekly rotating > team of editors/maintainers so that if a maintainer was unable or > unwilling to do his or her part then the work would only pile up for a > week for the next maintainer instead of remaining unfinished > indefinitely. You're right, trying to automate updates received by e-mail is a bad idea. Here's how we do it over at FreeBSD. I can attest from personal experience that this mechanism works. Put your documentation in to a CVS repository somewhere. You need some sort of structure for the directories under this repository, otherwise things become impossible to manage very quickly. Over at FreeBSD we've just finished a fairly large scale move to a new structure to facilitate the rapid adoption of new documentation with the least amount of pain. To describe it, briefly; At the top level, you have two types of directory; language specific, and non-language specific. Subdivide your languages by the code for the language used *and* the encoding mechanism used in that language (this is because some languages, like Chinese, can be written in more than one encoding, and there is not a 1:1 map between them). These are the vast majority of your directories. Have one other directory, share/, and this is where language independent stuff goes. On the FDP we have English, Spanish, Japanese, Chinese, and Russian translations (and French happening very soon), so right now, the directory structure looks like: % cd ~/FreeBSD-CVS/doc % ls CVS/ en_US.ISO_8859-1/ fr_FR.ISO_8859-1/ share/ es_ES.ISO_8859-1/ ja_JP.eucJP/ zh_TW.Big5/ ru_RU.KOI8-R/ Yes, I know those directory names look too long. What's wrong with just "en" or "es"? Trust me, you need to be able to cater for languages that support multiple encodings (like Chinese), and one day, we'll be supporting things like Unicode. So splitting things up by language and encoding *now* is the way to do it. You save a *lot* of future pain. There's also a Makefile in there, but I'm not going to show them. Take a look inside one of these language directories, like the English one, and you get % cd en_US.ISO_8859-1 % ls CVS/ articles/ books/ share/ So the documentation is divided in to two categories, books, and articles. There's a third directory, "share", which is for additional support files that are specific to this language (for example, the boilerplate license text might live in share/sgml/license.sgml, and be referenced in all the other documentation as an SGML entity. Note the categories -- books, and articles. There are no attempts to divide the documentation based on the content, but only the purely mechanical decision of "Is it a DocBook or an
?" Articles are appropriate for smaller HOWTOs and similar documents, books are appropriate for large bodies of documentation, such as the primer quoted earlier. IMPORTANT: The structure of the documentation in the CVS repository *DOES NOT* affect the structure of the documentation when it has been installed on to a user's disk. You can use various Makefile tricks to ensure that the same piece of documentation is installed under /usr/share/doc/printing, /usr/share/doc/win95, /usr/share/doc/articles, and /usr/share/doc/samba -- consider an article explaining how to use Samba to print to Windows 95; a user might expect to find that article under any of those directories on their installed system. You could even have a virtual category of "howto", if you wanted. The point is, you don't want to put these categories in the CVS directory structure -- instead, encode it as options in a Makefile/ So, the purpose of this division is simply to make it very, very, easy to decide where the documentation lives under the CVS tree. You could say "Why not put it all at this directory, and not bother with the books/ and articles/ distinction?". That's because there's one directory that I haven't shown you here, "man/". Yes, you can put manual pages under this infrastructure as well, so that a completely fleshed out directory would actually look like CVS/ articles/ books/ man/ share/ Then take a trip down in to books/, and you see % cd books % ls CVS/ fdp-primer/ faq/ handbook/ As you can see, this is where the FDP Primer, the FAQ, and the Handbook live. Again, I haven't shown the set of Makefile's that go along with these. Finally, in these subdirectories, you have the contents of the books themselves. That's how we structure the repository. It's clean, simple, logical, and, as I say, adding new documentation (or new translations) is trivial, because you have to expend almost zero effort in deciding where in the tree to put it. The books/articles/man distinction is simple, and the hardest part is coming up with the name of the 'leaf' directory (fdp-primer, handbook, etc). It also scales to new languages and new encodings very easily. Right, so you have this in a CVS repository somewhere. You need to make it easy for anyone to check stuff out of this repository -- that's pretty trivial, cvs can do it itself, or the cognoscenti use CVSup to make things go nice and fast. Now that anyone and everyone can download the source to your documentation, you need to make it easy for them to install the tools that they can use to edit the docs, convert them to other formats, and so on. On FreeBSD we have the "ports" system, which lets us easily bundle up multiple apps in a FreeBSD specific manner, and get them on to the end user's system. Someone that wants to get all the tools they need to produce HTML or RTF or text versions of the docs just needs to do # cd /usr/ports/textproc/docproj # make JADETEX=no install on their FreeBSD system, and come back when it's finished installing. Alternatively, they can do "... JADETEX=yes ...", and get the ability to produce PS and PDF output too. Actually calling these programs to convert the documentation is covered by the Makefiles that I didn't bother showing you earlier. All the author has to do is "make FORMATS=html" or "make FORMATS=ps" to see what their documentation looks like. Of course, most people aren't authors (or potential submitters), they just want to get the documentation in a usable format. In order to do this, they can download the FreeBSD Documentation Set packages from the FreeBSD FTP server, with a command like # pkg_add \ ftp://ftp.freebsd.org/pub/FreeBSD/docs/faq-en_US.ISO_8859-1.pdf.tgz And it will do the right thing (well, almost -- I'm putting the finishing touches to the infrastructure to support this now, so that's ready and usable by next week). These packages are (or will be) built daily. And because they fit in with the FreeBSD packaging system, the user can remove outdated ones, and install new ones, with pkg_delete. On a Linux system I imagine you'd use RPMs or DEBs, or whatever. So, this tackles the storage of the document source, getting it to authors, putting tools in the hands of the authors to maintain their documentation, and easily distributing the formatted documentation to end users. How about actually making changes to the documentation? There are two ways this can happen. The first is that you give the author an account on the host that holds the CVS archive, and you let them commit directly to the archive. This requires the author to know how to use CVS, and requires you to trust the authors that they won't inadvertently trash the archive. For some authors this is a problem, for others it isn't. For those that can do this, this is the simplest method. The slightly tougher method is through GNATS, the GNU action tracking system. Authors can use send-pr to submit updates to their documentation (as diffs, ideally) or they can post pointers to the latest SGML archive that they've put together. The committers can then process these diffs, and apply them to the documentation on the authors behalf. So, that's how authors can submit the changed versions of their documents back to the FDP, but what about end users, who might have spotted typos? Well, the end user can always send their comments to the author if they want, and the author can handle it that way. Or, the end users can use exactly the same mechanism as the authors, and use send-pr to submit fixes, typo corrections, and so on. Simple! There's one more thing -- with the implementation above, particularly the send-pr implementation, you will find that one or two people's names will frequently crop up in your list of people submitting PRs. You'll notice that their PRs are good quality, have accurate diffs, and always do the right thing. Press gang these people into joining you as soon as possible, because the biggest problem with any project like this is lack of manpower. Give them the rights to commit directly to the repository to fix things, and let them handle the incoming PRs. The FreeBSD Documentation Project is very fortunate to have volunteers of very high calibre working on it; some of them have been working on the FDP for years, others only joined in the past few months, but I am constantly impressed by the effort they put in. [ Here endeth the lesson :-) ] N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 11:52:40 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id AE7AC15333; Thu, 26 Aug 1999 11:48:40 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA83051; Thu, 26 Aug 1999 19:38:23 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id LAA67233; Thu, 26 Aug 1999 11:00:47 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Thu, 26 Aug 1999 11:00:47 +0100 From: Nik Clayton To: Mark Ovens Cc: Nik Clayton , doc@freebsd.org Subject: Re: How to build DocBook docs? Message-ID: <19990826110047.A66300@kilt.nothing-going-on.org> References: <19990822235910.F271@marder-1> <19990823134838.A2121@catkin.nothing-going-on.org> <19990825230641.C265@marder-1> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990825230641.C265@marder-1>; from Mark Ovens on Wed, Aug 25, 1999 at 11:06:41PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 25, 1999 at 11:06:41PM +0100, Mark Ovens wrote: > It now almost builds but gives the following errors/warnings: > > Quite a few of these - > > /usr/local/bin/jade:../../../share/sgml/freebsd.dsl:151:49:E: reference to undefined variable "question-answer-label" Your installation of the dsssl-docbook-modular port is out of date. You need version 1.40 and up (at least). > /usr/local/bin/jade:book.sgml:136:29:E: [xref to QUESTION unsupported] > /usr/local/bin/jade:book.sgml:137:38:E: [xref to QUESTION unsupported] What were you making? If it's the FAQ then your copy is out of date, as fix for this was committed on the 24th. If it's not the FAQ then I'm confused, as I can't duplicate this. > And it finally dies like this - > > /usr/local/bin/jade:staff/chapter.sgml:652:8:E: general entity "a.mtaylor" not defined and no default entity Hmm. mtaylor appears to have added themselves to staff/chapter.sgml without updating authors.ent. OK, that's a problem, but it's non-fatal. I'll fix that this evening (if I haven't been beaten to it). You should still get working HTML files out of the conversion. > /usr/local/bin/jade:../../../share/sgml/freebsd.dsl:151:49:E: reference to undefined variable "question-answer-label" That's the "Outdated dsssl-docbook-modular" problem again. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 11:54:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id E490715E64; Thu, 26 Aug 1999 11:54:38 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id TAA83053; Thu, 26 Aug 1999 19:38:23 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id LAA68964; Thu, 26 Aug 1999 11:14:47 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Thu, 26 Aug 1999 11:14:47 +0100 From: Nik Clayton To: Tim Vanderhoek Cc: Nik Clayton , Motoyuki Konno , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990826111447.C66300@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990825194348.G18970@ppp18415.on.bellglobal.com>; from Tim Vanderhoek on Wed, Aug 25, 1999 at 07:43:48PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 25, 1999 at 07:43:48PM -0400, Tim Vanderhoek wrote: > On Wed, Aug 25, 1999 at 11:55:10AM +0100, Nik Clayton wrote: > > > > I think we must. There are two reasons for this; > > > > 1. It makes the file easier to follow. If the file is easier to follow > > then it makes it easier to add new documentation, see the structure > > of the document, and so on. > > Are you objecting to my suggestion with this? I don't think I am. To use one of the first paragraphs of en*/books/handbook/ports/chapter.sgml as an example, you're thinking of turning For all the hype about open standards, getting a program to work on different versions of Unix in the real world can be a tedious and tricky business, as anyone who has tried it will know. You may be lucky enough to find that the program you want will compile cleanly on your system, install itself in all the right places and run flawlessly “out of the box”, but this is unfortunately rather rare. With most programs, you will find yourself doing a fair bit of head-scratching, and there are quite a few programs that will result in premature greying, or even chronic alopecia... into For all the hype about open standards, getting a program to work on different versions of Unix in the real world can be a tedious and tricky business, as anyone who has tried it will know. You may be lucky enough to find that the program you want will compile cleanly on your system, install itself in all the right places and run flawlessly “out of the box”, but this is unfortunately rather rare. With most programs, you will find yourself doing a fair bit of head-scratching, and there are quite a few programs that will result in premature greying, or even chronic alopecia... yes? I don't object to this (particularly as you say your planning on confining it to your own submissions) but I do note: 1. It removes some of the functionality of my favourite editor (*sniff*). 2. It reads oddly. It might just be my brain, but I can't read the altered one as a 'smooth' paragraph. The line breaks make it seem much more disjoint, which makes it harder to read it when proofing, or rewording. 3. I'm not convinced it actually makes things markedly easier for the translators, when compared to our current scheme of commiting content changes and white space changes in separate commits. But, these aren't objections, just notes. I don't see any reason why we can't try it out on some of your documentation for a few months, and, if it works out well, whistle up some Emacs Lisp, or Perl, or something, to automagically make the other English docs do this. I think Foxfair (I think it was, anyway) made an interesting suggestion which was to not bother doing this in the repository copies of the files, but to have some tool which could post-process DocBook documents so they looked like this. The translators would then check out the before and after versions of the document they're translating, run both copies through this tool (to get an 'easier to translate and/or see the diffs' version), and then base their translations on that. This then gives us the best of both worlds. Have I understood your proposal properly? N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 12: 9:25 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 80159153E4 for ; Thu, 26 Aug 1999 12:08:57 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id UAA87794; Thu, 26 Aug 1999 20:07:39 +0100 (BST) (envelope-from nik) Date: Thu, 26 Aug 1999 20:07:39 +0100 From: Nik Clayton To: Koga Youichirou Cc: freebsd-doc@FreeBSD.org Subject: Re: Japanese FAQ pages are broken Message-ID: <19990826200739.A86126@catkin.nothing-going-on.org> References: <199908261133.UAA11204@splpe481.ccs.mt.nec.co.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908261133.UAA11204@splpe481.ccs.mt.nec.co.jp>; from Koga Youichirou on Thu, Aug 26, 1999 at 08:33:49PM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 08:33:49PM +0900, Koga Youichirou wrote: > I found that Japanese FAQ pages are broken Fixed, I *think*. I don't follow the encoding issue completely, so I may have misunderstood the nature of the problem. However, the FAQ now appears in what looks like Japanese characters in my browser, and, more importantly, has the correct at the top. However, > (other Japanese pages, > e.g. handbook, are not broken). That concerns me. From my quick analysis of the problem, the Japanese Handbook should be broken in exactly the same way as the FAQ is, and I'm just about to commit the same fix and drop an updated version of the FAQ in place. I'm going to get this fixed first, then put together a longer message to -doc and doc-jp outlining what I think the problem is, and how I fixed it. I'll deal with the other issues after that. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 12:11:48 1999 Delivered-To: freebsd-doc@freebsd.org Received: from shell.futuresouth.com (shell.futuresouth.com [198.78.58.28]) by hub.freebsd.org (Postfix) with ESMTP id 5111915E11; Thu, 26 Aug 1999 12:11:43 -0700 (PDT) (envelope-from fullermd@futuresouth.com) Received: (from fullermd@localhost) by shell.futuresouth.com (8.9.3/8.9.3) id OAA18464; Thu, 26 Aug 1999 14:11:42 -0500 (CDT) Date: Thu, 26 Aug 1999 14:11:42 -0500 From: "Matthew D. Fuller" To: Nik Clayton Cc: Tim Vanderhoek , Motoyuki Konno , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990826141141.F24968@futuresouth.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.3i In-Reply-To: <19990826111447.C66300@kilt.nothing-going-on.org>; from Nik Clayton on Thu, Aug 26, 1999 at 11:14:47AM +0100 X-OS: FreeBSD Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [nit] On Thu, Aug 26, 1999 at 11:14:47AM +0100, a little birdie told me that Nik Clayton remarked > > into > > For all the hype about open standards, getting a program to work on > different versions of Unix in the real world can be a tedious and tricky > business, as anyone who has tried it will know. > You may be lucky enough to find that the program you want will compile > cleanly on your system, install itself in all the right places and run > flawlessly “out of the box”, but this is unfortunately > rather rare. > With most programs, you will find yourself doing a fair bit of > head-scratching, and there are quite a few programs that will result > in premature greying, or even chronic alopecia... I'm in favor of putting markup tags on their own line. Thus: For all the hype about open standards, getting a program to work on different versions of Unix in the real world can be a tedious and tricky business, as anyone who has tried it will know ... With most programs, you will find yourself doing a fair bit of head-scratching, and there are quite a few programs that will result in premature greying, or even chronic alopecia... But that may just be a personal quirk. -- Matthew Fuller (MF4839) | fullermd@over-yonder.net Unix Systems Administrator | fullermd@futuresouth.com Specializing in FreeBSD | http://www.over-yonder.net/ FutureSouth Communications | ISPHelp ISP Consulting "The only reason I'm burning my candle at both ends, is because I haven't figured out how to light the middle yet" To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 12:45: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 50338153D8 for ; Thu, 26 Aug 1999 12:44:53 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id UAA92216 for doc@freebsd.org; Thu, 26 Aug 1999 20:41:09 +0100 (BST) (envelope-from nik) Date: Thu, 26 Aug 1999 20:41:09 +0100 From: Nik Clayton To: doc@freebsd.org Subject: Latest Makefile tweaks Message-ID: <19990826204109.B86126@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Folks, I've just committed a few tweaks to doc/Makefile, doc/share/mk/docproj.docbook.mk, and doc/*/Makefile. These are all to enable "make release" working in harmony with the new tree. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 13:18:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 306C014C18 for ; Thu, 26 Aug 1999 13:13:21 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id XAA06483; Thu, 26 Aug 1999 23:11:52 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id XAA01504; Thu, 26 Aug 1999 23:03:08 +0400 (MSD) Date: Thu, 26 Aug 1999 23:03:07 +0400 From: Alexey Zelkin To: Anders Andersson Cc: freebsd-doc@FreeBSD.ORG Subject: Re: ndc(8) Message-ID: <19990826230307.A1440@scorpion.crimea.ua> References: <19990826100201.A33426@enterprise.sanyusan.se> <199908260834.MAA02365@scorpion.crimea.ua> <19990826135650.A44944@enterprise.sanyusan.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <19990826135650.A44944@enterprise.sanyusan.se> X-Operating-System: FreeBSD 2.2.7-RELEASE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Thu, Aug 26, 1999 at 01:56:50PM +0200, Anders Andersson wrote: > Making a complete patch was easier then I thought. > > This fixes the whole ndc(8) man page. > > Should I send-pr this? First off, make sure that logic of your patch is correct. Quick look on bind manpages shown me that named.8 is also will be changed. Make sure that it's system wide affected problem (it's not your local configuration change). Then you need to submit your changes to bind official maintainer. If it's FreeBSD specific patch then submit it using send-pr(1). PS: If you not sure -- just send-pr it, but note in Description that you're not sure, I'll check it :-) -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 13:23:23 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id DC21315475 for ; Thu, 26 Aug 1999 13:22:21 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id XAA06625; Thu, 26 Aug 1999 23:20:43 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id XAA01518; Thu, 26 Aug 1999 23:04:06 +0400 (MSD) Date: Thu, 26 Aug 1999 23:04:06 +0400 From: Alexey Zelkin To: Dani?l de Kok Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Dutch documentation Message-ID: <19990826230406.B1440@scorpion.crimea.ua> References: <000501beefed$a5436e60$0190fea9@tazzy> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <000501beefed$a5436e60$0190fea9@tazzy> X-Operating-System: FreeBSD 2.2.7-RELEASE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Thu, Aug 26, 1999 at 05:01:08PM +0200, Dani?l de Kok wrote: > Is there anybody working on Dutch documentation for FreeBSD? I think FreeBSD > is a great project, and I really would like to contribute to it... Check http://www.FreeBSD.org/docproj/translations.html#german -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 13:24:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id D247C14D1B for ; Thu, 26 Aug 1999 13:22:49 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA97136; Thu, 26 Aug 1999 21:20:16 +0100 (BST) (envelope-from nik) Date: Thu, 26 Aug 1999 21:20:16 +0100 From: Nik Clayton To: Anders Andersson Cc: freebsd-doc@FreeBSD.ORG Subject: Re: ndc(8) Message-ID: <19990826212016.D86126@catkin.nothing-going-on.org> References: <19990826100201.A33426@enterprise.sanyusan.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990826100201.A33426@enterprise.sanyusan.se>; from Anders Andersson on Thu, Aug 26, 1999 at 10:02:01AM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 10:02:01AM +0200, Anders Andersson wrote: > I found that ndc(8) man page is a little wrong, for example > > 'stats Causes named to dump its statistics to /var/tmp/named.stats' > > is not correct, since named.stats get dumped to /etc/namedb/named.stats. > > It should read: > > 'stats Causes named to dump its statistics to /etc/namedb/named.stats' > > This also applies for /var/tmp/named_dump.db, that one goes also in > /etc/namedb. Guys, before we fix the manpage on this, could someone please follow this up with -hackers? I was under the impression (but could be wrong) that programs weren't meant to do this sort of thing in /etc (or subdirectories of /etc) and that /var/ is the best place for them. As I say, I could be wrong, but it'd be nice to get confirmation from -hackers that this is the expected behaviour. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 13:25: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id CEF511544C for ; Thu, 26 Aug 1999 13:22:49 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA96911; Thu, 26 Aug 1999 21:18:30 +0100 (BST) (envelope-from nik) Date: Thu, 26 Aug 1999 21:18:30 +0100 From: Nik Clayton To: Makoto MATSUSHITA Cc: doc@freebsd.org, doc-jp@jp.freebsd.org Subject: Re: Japanese FAQ on the Web is broken Message-ID: <19990826211830.C86126@catkin.nothing-going-on.org> Reply-To: doc@freebsd.org References: <19990826192109K.matusita@matatabi.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990826192109K.matusita@matatabi.or.jp>; from Makoto MATSUSHITA on Thu, Aug 26, 1999 at 07:21:09PM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ Sent to -doc and doc-jp, reply-to points back to -doc ] On Thu, Aug 26, 1999 at 07:21:09PM +0900, Makoto MATSUSHITA wrote: > > Sorry if this is a well-known bug. > > , the entry page of > FreeBSD FAQ written in Japanese is broken (all characters are not a > japanese character!). Thanks for the pointer. I think this is now fixed, but I'd appreciate confirmation. Please be aware that I will be unable to commit to the tree for the next 24 hours or so because I'll be away from the computer, so any other fixes that need doing will need to be carried out by someone else (Jun, Jesus, Chris Costello, and John Baldwin are all committers who could probably carry this out, assuming any patches you come up with work OK on their systems). > Why? Who break? First, please understand that I don't fully understand the i18n issue, and would be hard-pressed to tell a good page from a bad one. I am relying on people like yourself being able to point out problems and possible solutions in situations like this. Having said that. . . This is tied to the DocBook stylesheets that we use. As you can see if you look at any of the webpages produced by the stylesheets, they do more than just convert the DocBook pages to pretty HTML. They also add text to the pages. In particular, they add the navigation links at the top and the bottom, and a few other bits and pieces as well. In order for the stylesheets to do this, they need to know what language your document is written in. The stylesheets come with the words "Next", "Previous", "Home", and sundry other pieces of boilerplate text translated in to a variety of different languages, including Japanese. The "normal" way to tell the stylesheets what language your document is written in is to add the 'lang="xx"' attribute to the first element in your document. For example, the Japanese Handbook (or FAQ) should start If you look at the Spanish FAQ you'll see it starts For reasons I don't fully understand (Jun Kuriyama is the expert here) this isn't working properly for the Japanese translation. I believe Jun has patches for this problem for the stylesheets, but they have not yet been incorporated in to the version we use (I think that's the case, but Jun might well correct me on this point). Because of this problem, we need to use a bit of a hack. If you look at the top of doc/share/sgml/freebsd.dsl, you'll see and then further down (define %html-header-tags% '(("META" ("HTTP-EQUIV" "Content-Type") ("CON TENT" "text/html; charset=EUC-JP")))) ]]> This is a rather convoluted way of saying If the tools that process the Japanese documentation have the command line flag '-ilang.ja' passed to them, add the additional HTML header tags "Content-Type", and set it to "text/html; charset=EUC-JP". This is what your web browser is looking for before it will switch to using a Japanese font -- note that you could still have told your browser to use a Japanese font and the page would like fine, but it's that header in the HTML (do "View Source" in any of the Japanese HTML pages to see it) that tells your browser to do this automatically. Now, if you look at one of the Japanese Makefiles (say, for the FAQ, in doc/ja_JP.eucJP/books/faq/Makefile) and look at r1.2 of this file, you'll see a line JADEOPTS= -ilang.ja TIDYFLAGS= -raw Jade and Tidy are the two programs used to produce the HTML pages, and, as you can see, one of these variables is set to "-ilang.ja". So, in theory, those HTML meta-tags that I mentioned earlier will be included, and all will be well. According to the CVS logs, Jun Kuriyama added those entries on the 23rd (i.e., Monday this week). However, all was obviously not well, so what was the problem? We certainly used to have a variable called JADEOPTS. However, on the 5th of May this year (so over three months ago) I suddenly realised what seemed to be a Makefile convention. Namely, Makefiles often build up the command lines to the programs they are going to run piece by piece, and as they do this, they stuff the command line they are building into a variable called OPTS, where is the name of the program it's for. However, when you run make(1) you can add to these options on the command line (or in the Makefile) by defining a variable called FLAGS. See, for example, the C compiler, and the use of the COPTS and CFLAGS variables. Back on 5/5, I realised that when I created docproj.docbook.mk that I'd got the use of these two variables the wrong way round. So I switched them (this is documented in r1.3 of docproj.docbook.mk. The net effect is that although Jun had added "JADEOPTS= -ilang.ja" to the Makefile earlier this week, this option was never being passed on to Jade when it was run. So the HTML pages never had that meta tag added to them, and your browser didn't automatically switch to the correct encoding. The simple fix, which I've committed, is to change JADEOPTS in faq/Makefile and handbook/Makefile to JADEFLAGS. I built the FAQ and Handbook with this on freefall, and installed it on the website. To my untrained eye it now looks better -- at least the fonts that my browser is using look suitably Japanese. However, the least word on whether it is fixed or not will have to come from yourselves. If it is still broken, I hope the above description gives you a head start in working out what the problem is, and submitting a fix. > I've checked and found that other pages are also broken; As I say, the Handbook will also have been broken, and for the same reason. However, if there are any other pages that have the same problem could you please let me know about them? Thanks, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 13:26: 9 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 7664614DAE for ; Thu, 26 Aug 1999 13:26:03 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA97749; Thu, 26 Aug 1999 21:24:54 +0100 (BST) (envelope-from nik) Date: Thu, 26 Aug 1999 21:24:54 +0100 From: Nik Clayton To: Jun Kuriyama Cc: freebsd-doc@freebsd.org Subject: Re: Japanese FAQ on www.freebsd.org is broken Message-ID: <19990826212454.E86126@catkin.nothing-going-on.org> References: <14277.26897.547628.68187Y@localhost.sky.rim.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <14277.26897.547628.68187Y@localhost.sky.rim.or.jp>; from Jun Kuriyama on Fri, Aug 27, 1999 at 01:19:29AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Aug 27, 1999 at 01:19:29AM +0900, Jun Kuriyama wrote: > Currently, Japanese FAQ is fully broken. I fixed this by adding two > variable into Makefile but make cannot find this modification so build > for www.freebsd.org is not updated. Bug in Wolfram's build process, I think. I've worked around it by blowing away the build directory each time the site is updated. It slows down the updates by a minute or so, but it's safer. > I've mailed this to wosch and nik, who should I report this problem to > fix as soon as possible? Wolfram normally (via the webmaster alias). He's on holiday, so reporting it to me is as good as any. Just keep in mind that I don't normally get the change to commit until 8pm or so UK time. If it absolutely positively definitely has to be done *right now* then you could try root@freefall.freebsd.org, but save that for dire emergencies. I don't think this situation would have counted as a dire emergency. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 16:11: 2 1999 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.cdrom.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 75C23154AD for ; Thu, 26 Aug 1999 16:11:00 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.cdrom.com (8.9.3/8.9.3) with ESMTP id QAA05410; Thu, 26 Aug 1999 16:10:42 -0700 (PDT) (envelope-from jkh@zippy.cdrom.com) To: Oresamachan Cc: doc@FreeBSD.ORG Subject: Re: Re[2]: Japanese FAQ on the Web is broken In-reply-to: Your message of "Fri, 27 Aug 1999 00:52:53 +0900." <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> Date: Thu, 26 Aug 1999 16:10:42 -0700 Message-ID: <5406.935709042@localhost> From: "Jordan K. Hubbard" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org ENOUGH! This conversation is no longer productive and needs to stop. As someone else has pointed out, the folks doing Spanish and other languages are quietly working through this transition period and that's what the Japanese folks need to start doing now. Just make it work, whatever that takes, and stop taking up everyone's time with reading these threads. Every minute that's spent in sending these emails is a minute that can't be used on actually doing the work to get us past this transition point and that's just a waste. Nik is doing the best he can, he's trying to fix whatever problems have arisen as a result of the change-over, give him a break! Do you think he's paid to do this? Do you think that yelling at him will make him do better work? The answer is a very loud NO to both those questions and people need to start considering that before they send their angry emails. This is not a discussion, this is a flame war and it needs to end now. - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 16:41:42 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix5.ix.netcom.com (dfw-ix5.ix.netcom.com [206.214.98.5]) by hub.freebsd.org (Postfix) with ESMTP id DCF4714C3E for ; Thu, 26 Aug 1999 16:41:32 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix5.ix.netcom.com (8.8.4/8.8.4) id SAA28833; Thu, 26 Aug 1999 18:40:29 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix5.ix.netcom.com via smap (V1.3) id rma028692; Thu Aug 26 18:39:36 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id QAA27295; Thu, 26 Aug 1999 16:39:27 -0700 (PDT) To: John Baldwin Cc: Oresamachan , doc@freebsd.org Subject: Re: Re[2]: Japanese FAQ on the Web is broken References: <199908261618.MAA09188@sable.cc.vt.edu> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 26 Aug 1999 16:39:17 -0700 In-Reply-To: John Baldwin's message of "Thu, 26 Aug 1999 12:18:22 -0400 (EDT)" Message-ID: Lines: 76 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I agree with Jordan that this discussion is not headed anywhere productive. But just to clarify the situation: * From: John Baldwin * not going to be 100% perfect the first time around. However, if you read the * archives for -doc/ you will notice that almost every time somebody started * griping and complaining about a glitch or a proposed claim, it was the Japanese * team that was jumping up and down while all the other translations worked to * make the change. The notable exception to this was the recent * /usr/local/share/doc/fdp vs. /usr/share/doc issue. That is the problem: the * French group hasn't been yelling or jumping up and down about this transition, * neither has the Spanish group or the Russian group. Instead, they have Um, the French group doesn't have to worry about reorganization because they didn't have anything to reorganize. ;) (As Nik said, the French guys have been waiting for "months" for this to happen, so their work can be imported.) As to why the Japanese group is always the one that has problems with moving things around, maybe it's because of this. === >> du -d 3 | grep -v CVS 38 ./en_US.ISO_8859-1/articles/fonts 22 ./en_US.ISO_8859-1/articles/formatting-media 37 ./en_US.ISO_8859-1/articles/mh 33 ./en_US.ISO_8859-1/articles/multi-os 41 ./en_US.ISO_8859-1/articles/new-users 78 ./en_US.ISO_8859-1/articles/programming-tools 18 ./en_US.ISO_8859-1/articles/diskless-x 274 ./en_US.ISO_8859-1/articles 275 ./en_US.ISO_8859-1/books/fdp-primer 2227 ./en_US.ISO_8859-1/books/handbook 326 ./en_US.ISO_8859-1/books/faq 2835 ./en_US.ISO_8859-1/books 8 ./en_US.ISO_8859-1/share/sgml 13 ./en_US.ISO_8859-1/share 48 ./en_US.ISO_8859-1/tutorials/ddwg 15 ./en_US.ISO_8859-1/tutorials/disklessx 68 ./en_US.ISO_8859-1/tutorials/ppp 143 ./en_US.ISO_8859-1/tutorials 3271 ./en_US.ISO_8859-1 316 ./es_ES.ISO_8859-1/FAQ 334 ./es_ES.ISO_8859-1/books/faq 341 ./es_ES.ISO_8859-1/books 663 ./es_ES.ISO_8859-1 319 ./ja_JP.eucJP/FAQ 1850 ./ja_JP.eucJP/books/handbook 342 ./ja_JP.eucJP/books/faq 2199 ./ja_JP.eucJP/books 3018 ./ja_JP.eucJP/man/man1 746 ./ja_JP.eucJP/man/man5 230 ./ja_JP.eucJP/man/man6 299 ./ja_JP.eucJP/man/man7 1927 ./ja_JP.eucJP/man/man8 6227 ./ja_JP.eucJP/man 8751 ./ja_JP.eucJP 25 ./share/sgml 18 ./share/mk 48 ./share 328 ./ru_RU.KOI8-R/FAQ 334 ./ru_RU.KOI8-R 246 ./zh_TW.Big5/FAQ 302 ./zh_TW.Big5/books/faq 309 ./zh_TW.Big5/books 561 ./zh_TW.Big5 13635 . === (I sorted the output by language to make it more readable.) There's simply much more stuff for the Japanese translation team to handle than any other languages.... Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 16:49:24 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix5.ix.netcom.com (dfw-ix5.ix.netcom.com [206.214.98.5]) by hub.freebsd.org (Postfix) with ESMTP id DE8DF15D56 for ; Thu, 26 Aug 1999 16:49:19 -0700 (PDT) (envelope-from asami@cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix5.ix.netcom.com (8.8.4/8.8.4) id SAA29881; Thu, 26 Aug 1999 18:49:07 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix5.ix.netcom.com via smap (V1.3) id rma029853; Thu Aug 26 18:48:40 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id QAA27333; Thu, 26 Aug 1999 16:48:37 -0700 (PDT) Date: Thu, 26 Aug 1999 16:48:37 -0700 (PDT) Message-Id: <199908262348.QAA27333@silvia.hip.berkeley.edu> X-Authentication-Warning: silvia.hip.berkeley.edu: asami set sender to asami@cs.berkeley.edu using -f To: Makoto MATSUSHITA Cc: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken References: <19990826192109K.matusita@matatabi.or.jp> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Makoto MATSUSHITA * Why? Who break? Is it a declaration of that FDP * only supports laten-1 character set ? :-) This is quite clearly a tongue-in-cheek remark and a poor attempt at humor. (At least it's clear that it's supposed to be a humor...see the smiley.) You guys shouldn't jump on the guy because his command on the language is not good enough that he botched what he intended as a light-hearted joke. He was just reporting a bug, after all. And if you think the four or whatever number of messages reporting the bug was suprisingly many, you should see the Japanese mailing lists, there were much more over there, while only four bothered to report it to the English lists. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 17:12:27 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix16.ix.netcom.com (dfw-ix16.ix.netcom.com [206.214.98.16]) by hub.freebsd.org (Postfix) with ESMTP id 8F3F814BE9 for ; Thu, 26 Aug 1999 17:12:24 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix16.ix.netcom.com (8.8.4/8.8.4) id TAA19946; Thu, 26 Aug 1999 19:12:08 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix16.ix.netcom.com via smap (V1.3) id rma019809; Thu Aug 26 19:11:33 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id RAA27452; Thu, 26 Aug 1999 17:11:25 -0700 (PDT) To: Neil Blakey-Milner Cc: doc@FreeBSD.ORG Subject: Re: Japanese FAQ on the Web is broken References: <19990827001554V.matusita@matatabi.or.jp> <37C562D5280.4883ORESAMACHAN@cosmo.jah.ne.jp> <19990826180557.A75341@rucus.ru.ac.za> From: asami@FreeBSD.ORG (Satoshi - Ports Wraith - Asami) Date: 26 Aug 1999 17:11:24 -0700 In-Reply-To: Neil Blakey-Milner's message of "Thu, 26 Aug 1999 18:05:57 +0200" Message-ID: Lines: 18 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Neil Blakey-Milner * I think he does. I believe it may be because all of a sudden, in a * row, there were 4 mails from Japanese users complaining about the * FAQ encoding. I definately began to wonder whether this was perhaps * organized by the Japanese section of the FDP to show support. Ah, conspiracy theories. I knew someone would jump to this conclusion when the messages showed up in succession. The truth is, I saw people complaining to the Japanese lists, so I posted a message asking them to send mail to the English lists too when there's a problem so Nik and everybody else working on the framework will have a better idea on what's going on. (And many members of the Japanese doc team read -doc, so it's not like they won't see the messages.) Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 17:28:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix10.ix.netcom.com (dfw-ix10.ix.netcom.com [206.214.98.10]) by hub.freebsd.org (Postfix) with ESMTP id 0684715462; Thu, 26 Aug 1999 17:28:15 -0700 (PDT) (envelope-from asami@cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix10.ix.netcom.com (8.8.4/8.8.4) id TAA25804; Thu, 26 Aug 1999 19:28:05 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix10.ix.netcom.com via smap (V1.3) id rma025292; Thu Aug 26 19:25:12 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id RAA27527; Thu, 26 Aug 1999 17:24:48 -0700 (PDT) Date: Thu, 26 Aug 1999 17:24:48 -0700 (PDT) Message-Id: <199908270024.RAA27527@silvia.hip.berkeley.edu> X-Authentication-Warning: silvia.hip.berkeley.edu: asami set sender to asami@cs.berkeley.edu using -f To: nik@freebsd.org Cc: nik@freebsd.org, doc@freebsd.org In-reply-to: <19990825001406.A62322@catkin.nothing-going-on.org> (message from Nik Clayton on Wed, 25 Aug 1999 00:14:06 +0100) Subject: Re: Default FDP docs installation directory? From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990825001406.A62322@catkin.nothing-going-on.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Nik Clayton * Please can you look at * * * * and let me know if that's the sort of format you want to see. If you * need any tweaks we should be able to accomodate them. Yes, that looks much better. If you ask me, I'd prefer sections with more than one version number component to not have the period at the end (e.g., 4.6 instead of 4.6.) but I can live with what you have now. Also, glancing around the handbook, I noticed that the "home" and "up" links are only at the bottom of each page. Can you add them to the top as well? Thanks Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 18:41: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from martini.ics.es.osaka-u.ac.jp (martini.ics.es.osaka-u.ac.jp [133.1.12.150]) by hub.freebsd.org (Postfix) with ESMTP id 6000815CB5 for ; Thu, 26 Aug 1999 18:40:50 -0700 (PDT) (envelope-from matusita@matatabi.or.jp) Received: from localhost (localhost [127.0.0.1]) by martini.ics.es.osaka-u.ac.jp (8.9.3/3.7W/INO-1.0v8-SLAVE) with ESMTP id KAA94572 for ; Fri, 27 Aug 1999 10:39:40 +0900 (JST) In-Reply-To: <19990826211830.C86126@catkin.nothing-going-on.org> References: <19990826192109K.matusita@matatabi.or.jp> <19990826211830.C86126@catkin.nothing-going-on.org> X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94b51 XEmacs/21.2 (Toshima) X-SKK-Version: 10.49 X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) X-Fingerprint: 0C AC 93 FC E3 9D 9E 5B 3D B8 AC 5C 4A 79 D8 A6 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 990818(IM122) Lines: 19 From: Makoto MATSUSHITA (=?ISO-2022-JP?B?GyRCJF4kRCQ3JD8kXiQzJEgbKEI=?=) To: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken Date: Fri, 27 Aug 1999 10:39:38 +0900 Message-Id: <19990827103938O.matusita@matatabi.or.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org nik> Thanks for the pointer. I think this is now fixed, but I'd appreciate nik> confirmation. There are still some strange characters in documents, but most of them are fine to read, very thank you. I'm going to describe some documents and I wanna import some sentence and pointers from the FAQ. I've just completed my work, again, thank you. nik> As I say, the Handbook will also have been broken, and for the nik> same reason. However, if there are any other pages that have the nik> same problem could you please let me know about them? Ahhh, I want to say in previous mail that other FAQ documents (not only the entry page of FAQ) are also broken. Sorry I do not check other pages at www.freebsd.org... -- - Makoto `MAR' MATSUSHITA To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 18:48: 9 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix7.ix.netcom.com (dfw-ix7.ix.netcom.com [206.214.98.7]) by hub.freebsd.org (Postfix) with ESMTP id 75F5F15434; Thu, 26 Aug 1999 18:47:58 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix7.ix.netcom.com (8.8.4/8.8.4) id UAA16310; Thu, 26 Aug 1999 20:47:48 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix7.ix.netcom.com via smap (V1.3) id rma016293; Thu Aug 26 20:47:22 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id SAA28006; Thu, 26 Aug 1999 18:46:39 -0700 (PDT) To: "Jordan K. Hubbard" Cc: Nik Clayton , jack , current@freebsd.org, doc@freebsd.org Subject: Re: Docs blows up make release References: <16783.935616425@localhost> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 26 Aug 1999 18:46:38 -0700 In-Reply-To: "Jordan K. Hubbard"'s message of "Wed, 25 Aug 1999 14:27:05 -0700" Message-ID: Lines: 45 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: "Jordan K. Hubbard" * > This makes the ports tree have a dependency on the doc tree. I don't think * > this dependency should be there. It's bad enough that the src/ tree * > depends on doc/ (and the reason I want the documentation available as * > packages is to remove this dependency), having ports depend on the doc tree * > as well just means that when things go out of sync in doc for a while I get * > both you and Satoshi complaining at me, instead of just you :-) * * Erm, I think the ports tree is pretty darn loose about "dependencies" * since they're easily updated. Consider, for example, the fact that * some ports are dependent on the organization of binary tarballs over * at Netscape, or depend on WordPerfect's linux distribution RPM. Those * are some pretty heavy deps, and depending on something in our own doc * tree is certainly no worse. :) Yes. It shouldn't be hard to keep them synced, just like all the other ports that require the src tree to be around. Another advantage of having them in the ports tree is the build checking done at regular intervals. All the japanese/handbook stuff that's going on right now, these are the problems of the textproc/docbook* ports (missing files from PLIST, missing dependencies). People installing these from packages will see the exact same problem when they try to build the handbook (with or without the japanese/handbook port). * > Putting the package building rules in the doc/ Makefiles also (and this * > is just my personal opinion) makes it easier for people to see how the * > documentation packages are built. The ports Makefile structure is a * > marvel, but it contains a lot of code that's not necessary for building * > documentation packages (the "automagically add man pages to the PLIST * > i" code, for example) that makes it more difficult for the interested * > learner to browse and understand what's going on. * * Now this is a point which is more germin. So, you figure on making a * similar sort of "package" target under doc? I guess it really doesn't * matter where these things live, as long as it's still automated.. The chief concern I have is that this might result in yet another place you (Jordan) have to pick up stuff from before the release. Having these as ports will at least put them on the normal distribution channel along with all the other packages. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 18:50: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id C90A414F64 for ; Thu, 26 Aug 1999 18:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id SAA12230; Thu, 26 Aug 1999 18:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from cc158233-a.catv1.md.home.com (cc158233-a.catv1.md.home.com [24.3.25.17]) by hub.freebsd.org (Postfix) with ESMTP id 5CE1A15EC2 for ; Thu, 26 Aug 1999 18:41:03 -0700 (PDT) (envelope-from sjr@home.net) Received: (from sjr@localhost) by cc158233-a.catv1.md.home.com (8.9.3/8.9.3) id VAA14591; Thu, 26 Aug 1999 21:40:41 -0400 (EDT) (envelope-from sjr) Message-Id: <199908270140.VAA14591@cc158233-a.catv1.md.home.com> Date: Thu, 26 Aug 1999 21:40:41 -0400 (EDT) From: sjr@home.com Reply-To: sjr@home.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13403: FAQ update for memory limits Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13403 >Category: docs >Synopsis: FAQ update for memory limits >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Aug 26 18:50:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Stephen J. Roznowski >Release: FreeBSD 4.0-CURRENT i386 >Organization: >Environment: >Description: The FAQ entry for memory limits should be updated. I've pieced together the following from various discussions that have occurred on the various mailing lists. >How-To-Repeat: >Fix: --- en_US.ISO_8859-1/books/faq/book.sgml.orig Thu Aug 26 21:34:26 1999 +++ en_US.ISO_8859-1/books/faq/book.sgml Thu Aug 26 21:34:57 1999 @@ -1536,10 +1536,13 @@ What are the limits for memory? -For memory, the (theoretical) limit is 4 gigabytes. One gigabyte -has been tested; you generally can't buy i386 PCs that can support -much more than that. - +For memory, the limit is 4 gigabytes. This configuration has +been tested . +If you plan to install this much memory into a machine, you need to +be careful. You'll probably want to use ECC memory and to reduce +capacitive loading use 9 chip memory modules vice 18 chip memory +modules. + >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 20:50:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id BB4EC15293 for ; Thu, 26 Aug 1999 20:50:26 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id UAA27223; Thu, 26 Aug 1999 20:50:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from khavrinen.lcs.mit.edu (khavrinen.lcs.mit.edu [18.24.4.193]) by hub.freebsd.org (Postfix) with ESMTP id 2E6F015293 for ; Thu, 26 Aug 1999 20:49:38 -0700 (PDT) (envelope-from wollman@khavrinen.lcs.mit.edu) Received: (from wollman@localhost) by khavrinen.lcs.mit.edu (8.9.1/8.9.1) id XAA04264; Thu, 26 Aug 1999 23:48:09 -0400 (EDT) (envelope-from wollman) Message-Id: <199908270348.XAA04264@khavrinen.lcs.mit.edu> Date: Thu, 26 Aug 1999 23:48:09 -0400 (EDT) From: Garrett Wollman Reply-To: wollman@khavrinen.lcs.mit.edu To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13406: ctime(3) has one grammar errors and one spelling eror Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13406 >Category: docs >Synopsis: ctime(3) has one grammar errors and one spelling eror >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 Aug 26 20:50:03 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Garrett Wollman >Release: FreeBSD 3.0-CURRENT i386 >Organization: MIT LCS >Environment: Irrelevant. >Description: Bad English in ctime(3). >How-To-Repeat: man ctime >Fix: Index: ctime.3 =================================================================== RCS file: /home/cvs/src/lib/libc/stdtime/ctime.3,v retrieving revision 1.8 diff -u -r1.8 ctime.3 --- ctime.3 1999/01/03 01:07:41 1.8 +++ ctime.3 1999/08/26 00:54:04 @@ -175,7 +175,7 @@ .Fn mktime and .Fn timegm -converts the broken-down time in the structure +convert the broken-down time in the structure pointed to by tm into a time value with the same encoding as that of the values returned by the .Xr time 3 @@ -303,10 +303,15 @@ .St -iso9945-1 (again provided the selected local timezone does not contain a leap-second table). +.Pp +The +.Fn timegm +function is not specified by any standard; its function cannot be +completely emulated using the standard functions described above. .Sh HISTORY This manual page is derived from the time package contributed to Berkeley by -Arthur Olsen and which appeared in +Arthur Olson and which appeared in .Bx 4.3 . .Sh BUGS Except for >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Aug 26 22:33:53 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 45CB114FEB; Thu, 26 Aug 1999 22:33:50 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18415.on.bellglobal.com (ppp18351.on.bellglobal.com [206.172.130.31]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id BAA11373; Fri, 27 Aug 1999 01:32:14 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id BAA48832; Fri, 27 Aug 1999 01:30:22 -0400 (EDT) (envelope-from tim) Date: Fri, 27 Aug 1999 01:30:21 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: Motoyuki Konno , freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990827013021.B47771@ppp18415.on.bellglobal.com> Reply-To: hoek@freebsd.org References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990826111447.C66300@kilt.nothing-going-on.org>; from Nik Clayton on Thu, Aug 26, 1999 at 11:14:47AM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 11:14:47AM +0100, Nik Clayton wrote: > > 2. It reads oddly. It might just be my brain, but I can't read the Yes, although I expect that my brain, at least, will adapt. My brain does that, sometimes. :) > 3. I'm not convinced it actually makes things markedly easier for the > translators, when compared to our current scheme of commiting content > changes and white space changes in separate commits. I was updating the badly neglected top half of ports/chapter.sgml when I realized that I was slowly losing complete track of changes. Editing 80+ character lines is just too hard. It's far easier to add an arbitrary line break, like when editing mdoc files. > But, these aren't objections, just notes. I don't see any reason why we > can't try it out on some of your documentation for a few months, and, if Heh. I don't think I produce enough documentation to qualify as a "test trial". :) > Have I understood your proposal properly? I may sometimes make more aggressive use of linebreaks than in your examples, but yes. -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 0:10:44 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 8F82714CA6 for ; Fri, 27 Aug 1999 00:10:42 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA42088; Fri, 27 Aug 1999 00:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Fri, 27 Aug 1999 00:10:01 -0700 (PDT) Message-Id: <199908270710.AAA42088@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Alexey Zelkin Subject: Re: docs/13406: ctime(3) has one grammar errors and one spelling eror Reply-To: Alexey Zelkin Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13406; it has been noted by GNATS. From: Alexey Zelkin To: Garrett Wollman Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/13406: ctime(3) has one grammar errors and one spelling eror Date: Fri, 27 Aug 1999 09:39:32 +0400 hi, > >Number: 13406 > >Category: docs > >Synopsis: ctime(3) has one grammar errors and one spelling eror And as well as continue applying PR's patch apply: Index: ctime.3 =================================================================== RCS file: /usr/local/CVSROOT/src/lib/libc/stdtime/ctime.3,v retrieving revision 1.8 diff -u -r1.8 ctime.3 --- ctime.3 1999/01/03 01:07:41 1.8 +++ ctime.3 1999/08/27 07:40:55 @@ -306,7 +306,8 @@ .Sh HISTORY This manual page is derived from the time package contributed to Berkeley by -Arthur Olsen and which appeared in +.An Arthur Olson +and which appeared in .Bx 4.3 . .Sh BUGS Except for -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 0:40: 5 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 99B1214E06 for ; Fri, 27 Aug 1999 00:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA44221; Fri, 27 Aug 1999 00:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 48C1C14E06 for ; Fri, 27 Aug 1999 00:33:09 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id KAA26312 for FreeBSD-gnats-submit@freebsd.org; Fri, 27 Aug 1999 10:32:06 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id KAA01170; Fri, 27 Aug 1999 10:24:26 +0400 (MSD) Message-Id: <199908270624.KAA01170@scorpion.crimea.ua> Date: Fri, 27 Aug 1999 10:24:26 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13408: [PATCH] diffburst.1 has -mdoc style inconsistences Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13408 >Category: docs >Synopsis: diffbusrt.1 has style inconsistences >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: Fri Aug 27 00:40:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped few days ago >Description: Just mdoc(7) style problems. >How-To-Repeat: >Fix: Index: diffburst.1 =================================================================== RCS file: /usr/local/CVSROOT/src/tools/tools/diffburst/diffburst.1,v retrieving revision 1.1 diff -c -r1.1 diffburst.1 *** diffburst.1 1999/01/07 19:28:56 1.1 --- diffburst.1 1999/08/27 08:26:24 *************** *** 13,19 **** contains the diff for a single file. The files are named patch-aa, patch-ab, and so on. .Pp ! This program is intended to aid in developing FreeBSD ports, where the 'one patchfile per file' rule applies. ! .Sh AUTHOR ! Archie Cobbs --- 13,21 ---- contains the diff for a single file. The files are named patch-aa, patch-ab, and so on. .Pp ! This program is intended to aid in developing ! .Fx ! ports, where the 'one patchfile per file' rule applies. ! .Sh AUTHORS ! .An Archie Cobbs Aq archie@whistle.com >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 1:50:30 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id D9FE51591A for ; Fri, 27 Aug 1999 01:50:27 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id BAA49093; Fri, 27 Aug 1999 01:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 70A8D14D2E for ; Fri, 27 Aug 1999 01:41:51 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id LAA27544 for FreeBSD-gnats-submit@freebsd.org; Fri, 27 Aug 1999 11:41:07 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id LAA01608; Fri, 27 Aug 1999 11:05:27 +0400 (MSD) Message-Id: <199908270705.LAA01608@scorpion.crimea.ua> Date: Fri, 27 Aug 1999 11:05:27 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13409: [PATCH] litle -mdoc for getopt.1 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13409 >Category: docs >Synopsis: -mdoc style fix for getopt.1 >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: Fri Aug 27 01:50:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped few days ago >Description: Style fix. Author always should be marked .An >How-To-Repeat: >Fix: Index: getopt.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.bin/getopt/getopt.1,v retrieving revision 1.7 diff -c -r1.7 getopt.1 *** getopt.1 1999/04/04 13:49:10 1.7 --- getopt.1 1999/08/27 09:07:40 *************** *** 91,97 **** status > 0 when it encounters an option letter not included in .Ar optstring . .Sh HISTORY ! Written by Henry Spencer, working from a Bell Labs manual page. Behavior believed identical to the Bell version. Example changed in .Fx version 3.2 and 4.0. --- 91,99 ---- status > 0 when it encounters an option letter not included in .Ar optstring . .Sh HISTORY ! Written by ! .An Henry Spencer , ! working from a Bell Labs manual page. Behavior believed identical to the Bell version. Example changed in .Fx version 3.2 and 4.0. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 7:32:23 1999 Delivered-To: freebsd-doc@freebsd.org Received: from saturno.solve.com.br (saturno.solve.com.br [200.197.163.66]) by hub.freebsd.org (Postfix) with ESMTP id D9C391550C for ; Fri, 27 Aug 1999 07:31:50 -0700 (PDT) (envelope-from francisco@genesys.inf.br) Received: from candiru.intranet.genesys.inf.br (genesys [200.197.163.138]) by saturno.solve.com.br (8.8.5/8.8.5) with ESMTP id LAA26108 for ; Fri, 27 Aug 1999 11:42:07 -0300 Received: from cuca.suporte.intranet.genesys.inf.br (genesys.inf.br) [10.1.6.17] by candiru.intranet.genesys.inf.br with esmtp (Exim 2.05 #1 (Debian)) id 11KNEl-0007yX-00; Fri, 27 Aug 1999 11:44:15 -0300 Message-ID: <37C6A391.CF5B69C9@genesys.inf.br> Date: Fri, 27 Aug 1999 11:41:21 -0300 From: francisco X-Mailer: Mozilla 4.6 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Ajudar... Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Bem, gostaria e muito em ajudar o projeto, depois de atuar muito tempo em solaris, experimentei diversas versòes de linux.... achei o debian e o slackware as mais profissionais, então conheci o FreeBSD e deixei "os linux" um pouco de lado e gostaria de trabalhar em prol da popularização do FreeBSD. Francisco... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 10:11:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 54ACC14CFA for ; Fri, 27 Aug 1999 10:11:41 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA30840; Fri, 27 Aug 1999 10:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from drago.cert.org.tw (drago.cert.org.tw [140.117.100.10]) by hub.freebsd.org (Postfix) with ESMTP id 6031B14E4B for ; Fri, 27 Aug 1999 10:00:22 -0700 (PDT) (envelope-from foxfair@drago.cert.org.tw) Received: (from foxfair@localhost) by drago.cert.org.tw (8.9.3/8.9.3) id AAA31552; Sat, 28 Aug 1999 00:58:30 +0800 (CST) Message-Id: <199908271658.AAA31552@drago.cert.org.tw> Date: Sat, 28 Aug 1999 00:58:30 +0800 (CST) From: Foxfair Hu Reply-To: foxfair@drago.cert.org.tw To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13411: Update book.sgml of en_US.ISO_8859-1/books/faq Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13411 >Category: docs >Synopsis: Update book.sgml of en_US.ISO_8859-1/books/faq >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: Fri Aug 27 10:10:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Foxfair Hu >Release: FreeBSD 4.0-CURRENT i386 >Organization: >Environment: FreeBSD 4.0-CURRENT i386. doc tree update to 1999/8/26. >Description: 1. I made some changes to the FAQ file, the old one will make some strange link (Like this : "Q:Q:") in the html files. So change to . 2. In the Chapter 9, Networking section, there is a wrong link. GaTeD has a new location now.(http://www.gated.org/). 3. Fix a weird @ tag, It looks like we just need a single "@" but not to mail somebody anonymous. I proposed to use <@> instead of @. 4. Others changes, too long and trivial to say, see the patch. >How-To-Repeat: Go to http://www.FreeBSD.org/FAQ/ and pick up [networking,ppp,else] chapters , you will see the Q: Q: links and something wrong. >Fix: Apply this patch, it has 339 lines and need *somebody else* to check it :-) --- book.sgml.org Fri Aug 27 23:54:27 1999 +++ book.sgml Sat Aug 28 00:37:46 1999 @@ -133,8 +133,8 @@ -current if you're sure that you're prepared for its increased volatility (relative to -stable, that is). -Releases are only made . While many people stay more up-to-date with the -FreeBSD sources (see the questions on and ) than that, doing so is more of a +Releases are only made every few months. While many people stay more up-to-date with the +FreeBSD sources (see the questions on FreeBSD-current and FreeBSD-stable) than that, doing so is more of a commitment, as the sources are a moving target. @@ -300,7 +300,7 @@ FreeBSD source tree. However, most non-trivial changes are discussed in advance in the -, and there are no restrictions +mailing lists, and there are no restrictions on who may take part in the discussion. @@ -346,7 +346,7 @@ 4.0 Snapshot releases are made once a day for the - branch, these being of service +-current branch, these being of service purely to bleeding-edge testers and developers. @@ -355,38 +355,46 @@ FreeBSD is also available via CDROM, from the following place(s): -Walnut Creek CDROM -4041 Pike Lane, Suite F -Concord, CA 94520 USA -Orders: +1 800 786-9907 -Questions: +1 925 674-0783 -FAX: +1 925 674-0821 -email: WC Orders address -WWW: WC Home page + + Walnut Creek CDROM + 4041 Pike Lane, Suite F + Concord, CA 94520 USA + Orders: +1 800 786-9907 + Questions: +1 925 674-0783 + FAX: +1 925 674-0821 + email: WC Orders address + WWW: WC Home page + In Australia, you may find it at: -Advanced Multimedia Distributors -Factory 1/1 Ovata Drive -Tullamarine, Melbourne -Victoria -Australia -Voice: +61 3 9338 6777 - -CDROM Support BBS -17 Irvine St -Peppermint Grove WA 6011 -Voice: +61 9 385-3793 -Fax: +61 9 385-2360 + + Advanced Multimedia Distributors + Factory 1/1 Ovata Drive + Tullamarine, Melbourne + Victoria + Australia + Voice: +61 3 9338 6777 + + + + CDROM Support BBS + 17 Irvine St + Peppermint Grove WA 6011 + Voice: +61 9 385-3793 + Fax: +61 9 385-2360 + And in the UK: -The Public Domain & Shareware Library -Winscombe House, Beacon Rd -Crowborough -Sussex. TN6 1UL -Voice: +44 1892 663-298 -Fax: +44 1892 667-473 + + The Public Domain & Shareware Library + Winscombe House, Beacon Rd + Crowborough + Sussex. TN6 1UL + Voice: +44 1892 663-298 + Fax: +44 1892 667-473 + @@ -950,7 +958,7 @@ that's supposed to let you *just* make those floppies, but it's not really gelled yet. -To make a custom release, follow the instructions . +To make a custom release, follow the instructions here. @@ -1024,7 +1032,7 @@ That said, it does work on thousands of IDE based systems, so you'd do well to try it first before simply giving up. -If you have a SCSI drive with bad blocks, see . +If you have a SCSI drive with bad blocks, see this answer. @@ -1305,7 +1313,7 @@ This is classically a case of FreeBSD and DOS or some other OS -conflicting over their ideas of disk You will have to reinstall FreeBSD, but obeying the +conflicting over their ideas of disk geometry. You will have to reinstall FreeBSD, but obeying the instructions given above will almost always get you going. @@ -1332,7 +1340,7 @@ ISA devices, although one or two broken EISA and VLB devices may need it as well). -Also look at the section on if you have that much memory, +Also look at the section on >64M machines if you have that much memory, or if you're using a Compaq or other BIOS that lies about the available memory. @@ -1456,12 +1464,12 @@ current versions can generally be obtained by anonymous FTP from braae.ru.ac.za. -There is also a for the +There is also a mailing list for the discussion of non-US encryption software. For more information, send an email message with a single line saying ``help'' in the body of your message to -<majordomo@braae.ru.ac.za>. +majordomo@braae.ru.ac.za. @@ -1866,7 +1874,7 @@ When the mouse daemon is running, access to the mouse needs to be coordinated between the mouse daemon and other programs such as the -X Window. Refer to +X Window. Refer to another section on this issue". @@ -1874,7 +1882,7 @@ How do I cut and paste text with mouse in the text console? -Once you get the mouse daemon running (see ), hold down the button 1 (left button) +Once you get the mouse daemon running (see previous section), hold down the button 1 (left button) and move the mouse to select a region of text. Then, press the button 2 (middle button) or the button 3 (right button) to paste it at the text cursor. @@ -1977,7 +1985,7 @@ In general this will not cause any problems, but there are circumstances where you will take a hit, either in performance or -accuracy of the math emulation code (see the section ). In particular, drawing arcs in X will be +accuracy of the math emulation code (see the section on FP emulation). In particular, drawing arcs in X will be VERY slow. It is highly recommended that you buy a math co-processor; it's well worth it. @@ -2237,7 +2245,7 @@ to B-C, the default is A-B. The 742a EISA cards never had the ``>16MB'' problem mentioned in -the section . This is a +the section on >16 MB machines. This is a problem that occurs with the Vesa-Local Buslogic SCSI cards. @@ -2987,7 +2995,7 @@ Please take a look at the ports page for info on software packages ported to FreeBSD. The list currently tops 1800 and is growing daily, so come back to check often or subscribe to the freebsd-announce - for periodic updates on new +mailing list for periodic updates on new entries. Most ports should be available for the 2.2, 3.x and 4.0 @@ -4807,7 +4815,7 @@ -See the section on +See the section on building a kernel if you've no experience with building kernels. With this option, there should be less chance of synchronization @@ -4864,7 +4872,7 @@ Unfortunately there is no workaround for versions 2.0.X and 2.1.X. In versions 2.2 through 2.2.5, apply the following patch to /sys/i386/isa/psm.c and rebuild the kernel. See the -section on +section on building a kernel if you've no experience with building kernels. @@ -5062,7 +5070,7 @@ tell other systems on your network about your router; FreeBSD comes with the standard BSD routing daemon routed, or for more complex situations you may want to try -GaTeD (available by FTP from ftp.gated.Merit.EDU) which +GaTeD (available from http://www.gated.org/ ) which supports FreeBSD as of 3_5Alpha7. It is our duty to warn you that, even when FreeBSD is configured @@ -5093,7 +5101,7 @@ the TIS firewall toolkit on your FreeBSD box. -See also the section on . +See also the section on natd. @@ -6051,7 +6059,7 @@ trying to resolve a host name. A lot of the time, sendmail is the culprit. You should make sure that you tell sendmail not to do any DNS lookups in its configuration file. See -the section on for +the section on Mail Configuration for details on how to create your own configuration file and what should go into it. You may also want to add the following line to your .mc file: @@ -6503,16 +6511,6 @@ - - - - - - - - - - Serial Communications @@ -6558,7 +6556,7 @@ example. If these settings aren't right for your system, or if you've added modem cards or have more serial ports than your kernel is configured for, just reconfigure your kernel. See -section for +section about building a kernel for more details. @@ -6706,7 +6704,7 @@ -See the section below for information on how to make these settings +See the section on sending AT commands below for information on how to make these settings without resorting to an MS-DOS terminal program. Next, make an entry in /etc/ttys for the @@ -6870,10 +6868,10 @@ -The @ sign for the pn capability doesn't work! +The <@> sign for the pn capability doesn't work! -The @ sign in the phone number capability tells tip to look in -/etc/phones for a phone number. But the @ sign is +The <@> sign in the phone number capability tells tip to look in +/etc/phones for a phone number. But the <@> sign is also a special character in capability files like /etc/remote. Escape it with a backslash: @@ -6953,7 +6951,7 @@ and several thousand students trying to use them... Make an entry for your university in /etc/remote -and use \@ for the pn capability: +and use <\@> for the pn capability: big-university:\ @@ -7821,13 +7819,13 @@ number of working ports and packages. FreeBSD/AXP should be considered BETA quality software at this time. For status information, please join the -<freebsd-alpha@FreeBSD.org>. +freebsd-alpha@FreeBSD.orgmailing list. Interest has also been expressed in a port of FreeBSD to -the SPARC architecture, join the <freebsd-sparc@FreeBSD.org> if you are interested +the SPARC architecture, join the freebsd-sparc@FreeBSD.orgmailing list if you are interested in joining that project. For general discussion on new architectures, -join the <freebsd-platforms@FreeBSD.org> -. +join the freebsd-platforms@FreeBSD.org +mailing list. @@ -7843,7 +7841,7 @@ character major number 32 and block major number 8 have been reserved specifically for this purpose; please use them. In any case, we'd appreciate hearing about your driver on -<freebsd-hackers@FreeBSD.org>. +freebsd-hackers@FreeBSD.org. @@ -7879,7 +7877,7 @@ [This section was extracted from a mail written by Bill Paul on the -freebsd-current by Dag-Erling Coïdan Smørgrav, who fixed a few typos and added the bracketed +freebsd-current mailing list by Dag-Erling Coïdan Smørgrav, who fixed a few typos and added the bracketed comments] >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 10:27:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from terrapin.ru.ac.za (terrapin.ru.ac.za [146.231.128.6]) by hub.freebsd.org (Postfix) with ESMTP id 0673F1552B for ; Fri, 27 Aug 1999 10:27:41 -0700 (PDT) (envelope-from nbm@mithrandr.moria.org) Received: from duca.dialup.ru.ac.za ([146.231.98.24] helo=mithrandr.moria.org) by terrapin.ru.ac.za with esmtp (Exim 3.03 #1) id 11KPmS-0007Oq-00 for freebsd-doc@FreeBSD.ORG; Fri, 27 Aug 1999 19:27:13 +0200 Received: (qmail 7393 invoked by uid 1001); 27 Aug 1999 13:22:45 -0000 Date: Fri, 27 Aug 1999 15:22:44 +0200 From: Neil Blakey-Milner To: hoek@FreeBSD.ORG Cc: Nik Clayton , Motoyuki Konno , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990827152244.A7271@mithrandr.moria.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990827013021.B47771@ppp18415.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.1i In-Reply-To: <19990827013021.B47771@ppp18415.on.bellglobal.com>; from Tim Vanderhoek on Fri, Aug 27, 1999 at 01:30:21AM -0400 Organization: Rhodes University Computer Users' Society X-Operating-System: FreeBSD 4.0-CURRENT i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri 1999-08-27 (01:30), Tim Vanderhoek wrote: > I was updating the badly neglected top half of ports/chapter.sgml when > I realized that I was slowly losing complete track of changes. > Editing 80+ character lines is just too hard. It's far easier to add > an arbitrary line break, like when editing mdoc files. I imagine adding a line break won't hinder translations (at least in my tiny experience in translation), but just don't go about using par or your favourite five-finger-emacs-function that re-paragraphs the whole thing. Let me qualify this, since it doesn't quite sound like I want it to. If you're editing a line, and you're typing at or approaching 80 characters, adding a line break in your own change shouldn't be a problem. Introducing a line break because changes you've instituted earlier in the line cause original text to move forward over 80 characters should be avoided, as this gives the impression some work was done on that text. In no case should you then merge the new line you've created with the line after it. Your next commit is to do whatever whitespace changes you need to. At least that's my take at it. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 10:28:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from terrapin.ru.ac.za (terrapin.ru.ac.za [146.231.128.6]) by hub.freebsd.org (Postfix) with ESMTP id D09201553A for ; Fri, 27 Aug 1999 10:27:44 -0700 (PDT) (envelope-from nbm@mithrandr.moria.org) Received: from duca.dialup.ru.ac.za ([146.231.98.24] helo=mithrandr.moria.org) by terrapin.ru.ac.za with esmtp (Exim 3.03 #1) id 11KPmf-0007Oq-00 for freebsd-doc@FreeBSD.ORG; Fri, 27 Aug 1999 19:27:28 +0200 Received: (qmail 88322 invoked by uid 1001); 25 Aug 1999 21:05:51 -0000 Date: Wed, 25 Aug 1999 23:05:51 +0200 From: Neil Blakey-Milner To: Matthew Hunt Cc: jonathan michaels , freebsd-doc@FreeBSD.ORG Subject: Re: FreeBSD webdesign Message-ID: <19990825230551.A88294@mithrandr.moria.org> References: <19990817233734.80790.qmail@hotmail.com> <37BB0AEE.ED7B311F@nisser.com> <19990826051922.A6868@caamora.com.au> <19990825130845.B36450@wopr.caltech.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.1i In-Reply-To: <19990825130845.B36450@wopr.caltech.edu>; from Matthew Hunt on Wed, Aug 25, 1999 at 01:08:45PM -0700 Organization: Rhodes University Computer Users' Society X-Operating-System: FreeBSD 4.0-CURRENT i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed 1999-08-25 (13:08), Matthew Hunt wrote: > On Thu, Aug 26, 1999 at 05:19:22AM +1000, jonathan michaels wrote: > > > or someting long the lines of disabled people with various > > levels of visual acuity loss, the poor screen resolutions used > > by crts thes days, generally 70-90 dpi and finally those with > > colour diferentiation and distortion difficulties > > I'll be even more reactionary, reaching back to the good ol' days > when HTML didn't have a way to specify text and background colors. > I don't think web pages should be altering the background and text > colors that I have selected (traditional Mosaic black-on-grey). Cascading Style Sheets local mandatory settings are supposed to be the answer to this, but at the moment it's just a dream. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 10:48:16 1999 Delivered-To: freebsd-doc@freebsd.org Received: from terrapin.ru.ac.za (terrapin.ru.ac.za [146.231.128.6]) by hub.freebsd.org (Postfix) with ESMTP id EC04915573 for ; Fri, 27 Aug 1999 10:44:51 -0700 (PDT) (envelope-from nbm@mithrandr.moria.org) Received: from duca.dialup.ru.ac.za ([146.231.98.24] helo=mithrandr.moria.org) by terrapin.ru.ac.za with esmtp (Exim 3.03 #1) id 11KQ1i-0007ej-00 for doc@FreeBSD.org; Fri, 27 Aug 1999 19:42:59 +0200 Received: (qmail 12192 invoked by uid 1001); 27 Aug 1999 17:42:55 -0000 Date: Fri, 27 Aug 1999 19:42:55 +0200 From: Neil Blakey-Milner To: doc@FreeBSD.org Subject: First draft at splitting docproj.docbook.mk Message-ID: <19990827194255.A12153@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary=45Z9DzgjV8m4Oswq X-Mailer: Mutt 0.95.1i Organization: Rhodes University Computer Users' Society X-Operating-System: FreeBSD 4.0-CURRENT i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Hiya, Attached please find my attempt to split docproj.docbook.mk, and make them independent of system make files, when requested to be. I've built with NOINCLUDEMK set and unset, and I'd like more testing. Installation doesn't work yet, but I'm getting there. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Content-Description: doc.project.mk Content-Disposition: attachment; filename="doc.project.mk" # # $Id$ # # This include file is the FreeBSD Documentation Project # co-ordination make file. # # This file includes the other makefiles, which contain enough # knowledge to perform their duties without the system make files. # # Document-specific variables: # # DOCFORMAT Format of the document. Defaults to docbook. # docbook is also the only option currently. # # MAINTAINER This denotes who is responsible for maintaining # this section of the project. If unset, set to # doc@FreeBSD.org # # User-modifiable variables: # # PREFIX Standard path to document-building applications # installed to serve the documentation build # process, usually by installing the docproj port # or package. Default is /usr/local # # NOINCLUDEMK Whether to include the standard BSD make files, # or just to emulate them poorly. Set this if you # aren't on FreeBSD, or a compatible sibling. By # default is not set. # # Make files included: # # doc.install.mk Installation specific information, including # ownership and permissions. # # doc.subdir.mk Subdirectory related configuration, including # handling "obj" builds. # # DOCFORMAT-specific make files, like: # # doc.docbook.mk Building and installing docbook documentation. # Currently the only method. # # Document-specific defaults DOCFORMAT?= docbook FORMATS?= ${DEFAULT_FORMATS} MAINTAINER?= doc@FreeBSD.org # User-modifiable PREFIX?= /usr/local # Format-specific configuration .if ${DOCFORMAT} == "docbook" .include "doc.docbook.mk" .endif # Subdirectory handling and ownership information. .include "doc.subdir.mk" .include "doc.install.mk" --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Content-Description: doc.subdir.mk Content-Disposition: attachment; filename="doc.subdir.mk" # Taken from: # Id: bsd.subdir.mk,v 1.27 1999/03/21 06:43:40 bde # # $Id$ # # This include file contains the default targets # for building subdirectories in the FreeBSD Documentation Project. # # For all of the directories listed in the variable SUBDIR, the # specified directory will be visited and the target made. There is # also a default target which allows the command "make subdir" where # subdir is any directory listed in the variable SUBDIR. # # Document-specific variables: # # DISTRIBUTION Name of distribution. [doc] # # SUBDIR A list of subdirectories that should be # built as well. Each of the targets will # execute the same target in the # subdirectories. # # Provided targets: # # distribute: # This is a variant of install, which will # put the stuff into the right "distribution". # # afterdistribute, afterinstall, all, beforeinstall, checkdpadd, # clean, cleandepend, cleandir, depend, install, lint, maninstall, # obj, objlink, realinstall, regress, tags # .if exists(${.CURDIR}/../Makefile.inc) .include "${.CURDIR}/../Makefile.inc" .endif .if !defined(NOINCLUDEMK) .include .include .else .MAIN: all _SUBDIRUSE: .USE .for entry in ${SUBDIR} cd ${.CURDIR}/${entry} ${MAKE} ${.TARGET:realinstall=install} .endfor ${SUBDIR}:: cd ${.CURDIR}/${.TARGET} ${MAKE} all .for __target in all checkdpadd cleandepend cleandir depend lint \ maninstall objlink regress tags .if !target(${__target}) ${__target}: _SUBDIRUSE .endif .endfor .if !target(install) install: beforeinstall realinstall afterinstall .endif .for __target in beforeinstall afterinstall depend _SUBDIR .if !target(${__target}) ${__target}: .endif .endfor DISTRIBUTION?= doc .if !target(afterdistribute) afterdistribute: .endif .if !target(distribute) distribute: _SUBDIRUSE .for dist in ${DISTRIBUTION} cd ${.CURDIR} ; ${MAKE} afterdistribute DESTDIR=${DISTDIR}/${dist} .endfor .endif .if !target(obj) obj: _SUBDIRUSE @if ! test -d ${CANONICALOBJDIR}/; then \ mkdir -p ${CANONICALOBJDIR}; \ if ! test -d ${CANONICALOBJDIR}/; then \ ${ECHO} "Unable to create ${CANONICALOBJDIR}."; \ exit 1; \ fi; \ ${ECHO} "${CANONICALOBJDIR} created ${.CURDIR}"; \ fi .endif .if !target(objlink) objlink: _SUBDIRUSE @if test -d ${CANONICALOBJDIR}/; then \ rm -f ${.CURDIR}/obj; \ ln -s ${CANONICALOBJDIR} ${.CURDIR}/obj; \ else \ echo "No ${CANONICALOBJDIR} to link to - do a make obj."; \ fi .endif .if !target(whereobj) whereobj: @echo ${.OBJDIR} .endif cleanobj: @if [ -d ${CANONICALOBJDIR}/ ]; then \ rm -rf ${CANONICALOBJDIR}; \ else \ cd ${.CURDIR} && ${MAKE} clean cleandepend; \ fi @if [ -h ${.CURDIR}/obj ]; then rm -f ${.CURDIR}/obj; fi .if !target(clean) clean: _SUBDIRUSE .if defined(CLEANFILES) && !empty(CLEANFILES) rm -f ${CLEANFILES} .endif .if defined(CLEANDIRS) && !empty(CLEANDIRS) rm -rf ${CLEANDIRS} .endif .endif cleandir: cleanobj _SUBDIRUSE .endif # end of NOINCLUDEMK section --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Content-Description: doc.install.mk Content-Disposition: attachment; filename="doc.install.mk" # # $Id$ # # # This include file provides variables defining the default # ownership, location, and installation method of files generated by the # FreeBSD Documentation Project # # Since users often build and install documentation without root, # default the document ownership to them, if they're not root. # # Document-specific variables: # # NONE # # User-modifiabe variables: # # DOCGRP_OVERRIDE User may set this to a preferred group in the # case the documentation build is running as # non-root and desired group is not the user's # default group. # INSTALL_DOCS The command to use to install the documentation. # Defaults to "install -o user -g group -m 444", # roughly. # # Should honour DOCOWN, DOCGRP and DOCMODE. # # Should accept a list of files to install # followed by the directory to install into. # # INSTALL_FLAGS Flags to pass to the default INSTALL_DOCS' # install command. Useful options are [cCdDp]. # See install(1) for more information. # # DOCDIR Where to install the documentation. Default is # /usr/share/doc. # # DOCOWN Owner of the documents when installed. Forced # to the user installing the documentation, if the # user is not root. (for obvious reasons) # # DOCGRP Group of the documents when installed. Forced # to the primary group of the documentation, if # the user is not root. This action can be # overriden by setting: # # DOCGRP_OVERRIDE Override the use of primary group when the user # installing is not root. Sets GOCGRP to this # instead. # # DOCMODE Mode of the documents when installed. Defaults # to 444. See chmod(1). # # DOCDIR Installation directory. Defaults to # /usr/share/doc # # Make files included (if NOINCLUDEMK is not set): # # bsd.own.mk Default permissions and locations for install. # Include system defaults, unless prevented. .if !defined(NOINCLUDEMK) .include .endif DOCOWN?= root DOCGRP?= wheel DOCMODE?= 0444 DOCDIR?= /usr/share/doc # hack to set DOCOWN and DOCGRP to those of the user installing, if that # user is not root. USERID!= id -u USERNAME!= id -un GROUPNAME!= id -gn .if ${USERID} != 0 DOCOWN:= ${USERNAME} .if defined(DOCGRP_OVERRIDE) DOCGRP:= ${DOCGRP_OVERRIDE} .else DOCGRP:= ${GROUPNAME} .endif .endif # installation "script" INSTALL_DOCS?= \ ${INSTALL} ${INSTALL_FLAGS} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE} --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Content-Description: doc.docbook.mk Content-Disposition: attachment; filename="doc.docbook.mk" # # $Id$ # # This include file handles building and installing of # DocBook documentation in the FreeBSD Documentation Project. # # Documentation using DOCFORMAT=docbook is expected to be marked up # according to the DocBook DTD # # Document-specific variables # # DOC This should be set to the name of the DocBook # marked-up file, without the .sgml or .docb suffix. # # It also determins the name of the output files - # ${DOC}.html. # # DOCBOOKSUFFIX The suffix of your document, defaulting to .sgml # # Variables used by both users and documents: # # JADEFLAGS Additional options to pass to Jade. Typically # used to define "IGNORE" entities to "INCLUDE" # with "-i" # # TIDYFLAGS Additional flags to pass to Tidy. Typically # used to set "-raw" flag to handle 8bit characters. # # EXTRA_CATALOGS Additional catalog files that should be used by # any SGML processing applications. # # Documents should use the += format to access these. # MASTERDOC?= ${.CURDIR}/${DOC}.sgml JADE= ${PREFIX}/bin/jade DSLHTML= ${DOC_PREFIX}/share/sgml/freebsd.dsl DSLPRINT= ${DOC_PREFIX}/share/sgml/freebsd.dsl FREEBSDCATALOG= ${DOC_PREFIX}/share/sgml/catalog DOCBOOKCATALOG= ${PREFIX}/share/sgml/docbook/catalog JADECATALOG= ${PREFIX}/share/sgml/jade/catalog DSSSLCATALOG= ${PREFIX}/share/sgml/docbook/dsssl/modular/catalog JADEOPTS= ${JADEFLAGS} -c ${FREEBSDCATALOG} -c ${DSSSLCATALOG} -c ${DOCBOOKCATALOG} -c ${JADECATALOG} ${EXTRA_CATALOGS:S/^/-c /g} KNOWN_FORMATS= html html-split html-split.tar txt rtf ps pdf tex dvi tar # ------------------------------------------------------------------------ # # Look at ${FORMATS} and work out which documents need to be generated. # It is assumed that the HTML transformation will always create a file # called index.html, and that for every other transformation the name # of the generated file is ${DOC}.format. # # ${_docs} will be set to a list of all documents that must be made # up to date. # # ${CLEANFILES} is a list of files that should be removed by the "clean" # target. ${COMPRESS_EXT:S/^/${DOC}.${_cf}.&/ takes the COMPRESS_EXT # var, and prepends the filename to each listed extension, building a # second list of files with the compressed extensions added. # # Note: ".for _curformat in ${KNOWN_FORMATS}" is used several times in # this file. I know they could have been rolled together in to one, much # larger, loop. However, that would have made things more complicated # for a newcomer to this file to unravel and understand, and a syntax # error in the loop would have affected the entire # build/compress/install process, instead of just one of them, making it # more difficult to debug. # # Note: It is the aim of this file that *all* the targets be available, # not just those appropriate to the current ${FORMATS} and # ${INSTALL_COMPRESSED} values. # # For example, if FORMATS=html and INSTALL_COMPRESSED=gz you could still # type # # make book.rtf.bz2 # # and it will do the right thing. Or # # make install-rtf.bz2 # # for that matter. But don't expect "make clean" to work if the FORMATS # and INSTALL_COMPRESSED variables are wrong. # .for _curformat in ${FORMATS} _cf=${_curformat} .if ${_cf} == "html-split" _docs+= index.html HTML.manifest CLEANFILES+= `xargs < HTML.manifest` HTML.manifest .elif ${_cf} == "html-split.tar" _docs+= ${DOC}.html-split.tar CLEANFILES+= `xargs < HTML.manifest` HTML.manifest CLEANFILES+= ${DOC}.html-split.tar .elif ${_cf} == "html" _docs+= ${DOC}.html CLEANFILES+= ${DOC}.html .elif ${_cf} == "txt" _docs+= ${DOC}.txt CLEANFILES+= ${DOC}.html ${DOC}.txt .elif ${_cf} == "dvi" _docs+= ${DOC}.dvi CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex .elif ${_cf} == "ps" _docs+= ${DOC}.ps CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex ${DOC}.ps .elif ${_cf} == "pdf" _docs+= ${DOC}.pdf CLEANFILES+= ${DOC}.aux ${DOC}.dvi ${DOC}.log ${DOC}.tex ${DOC}.pdf .elif ${_cf} == "rtf" _docs+= ${DOC}.rtf CLEANFILES+= ${DOC}.rtf .elif ${_cf} == "tar" _docs+= ${DOC}.tar CLEANFILES+= ${DOC}.tar .elif ${_cf} == "doc" _docs+= ${DOC}.doc CLEANFILES+= ${DOC}.doc .endif .endfor # # Build a list of install-${format}.${compress_format} targets to be # by "make install". Also, add ${DOC}.${format}.${compress_format} to # ${_docs} and ${CLEANFILES} so they get built/cleaned by "all" and # "clean". # .if defined(INSTALL_COMPRESSED) && !empty(INSTALL_COMPRESSED) .for _curformat in ${FORMATS} _cf=${_curformat} .for _curcomp in ${INSTALL_COMPRESSED} .if ${_cf} != "html-split" _curinst+= install-${_curformat}.${_curcomp} _docs+= ${DOC}.${_curformat}.${_curcomp} CLEANFILES+= ${DOC}.${_curformat}.${_curcomp} .endif .endfor .endfor .endif .MAIN: all all: ${_docs} index.html HTML.manifest: ${SRCS} ${JADE} -V html-manifest -ioutput.html ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} -tidy -i -m -f /dev/null ${TIDYFLAGS} *.html ${DOC}.html: ${SRCS} ${JADE} -ioutput.html -V nochunks ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} > ${.TARGET} -tidy -i -m -f /dev/null ${TIDYFLAGS} ${.TARGET} ${DOC}.html-split.tar: HTML.manifest tar cf ${.TARGET} `xargs < HTML.manifest` ${DOC}.txt: ${DOC}.html lynx -nolist -dump ${.ALLSRC} > ${.TARGET} ${DOC}.rtf: ${SRCS} ${JADE} -Vrtf-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t rtf -o ${.TARGET} ${MASTERDOC} ${DOC}.doc: ${SRCS} ${JADE} -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t doc -o ${.TARGET} ${MASTERDOC} ${DOC}.tex: ${SRCS} ${JADE} -Vtex-backend -ioutput.print ${JADEOPTS} -d ${DSLPRINT} -t tex -o ${.TARGET} ${MASTERDOC} ${DOC}.dvi: ${DOC}.tex @echo "==> TeX pass 1/3" -tex "&jadetex" ${.ALLSRC} @echo "==> TeX pass 2/3" -tex "&jadetex" ${.ALLSRC} @echo "==> TeX pass 3/3" -tex "&jadetex" ${.ALLSRC} ${DOC}.pdf: ${DOC}.tex @echo "==> PDFTeX pass 1/3" -pdftex "&pdfjadetex" ${.ALLSRC} @echo "==> PDFTeX pass 2/3" -pdftex "&pdfjadetex" ${.ALLSRC} @echo "==> PDFTeX pass 3/3" pdftex "&pdfjadetex" ${.ALLSRC} ${DOC}.ps: ${DOC}.dvi dvips -o ${.TARGET} ${.ALLSRC} ${DOC}.tar: ${SRCS} tar cf ${.TARGET} ${.ALLSRC} # ------------------------------------------------------------------------ # # Validation targets # # # Lets you quickly check that the document conforms to the DTD without # having to convert it to any other formats # lint validate: nsgmls -s -c ${FREEBSDCATALOG} -c ${DOCBOOKCATALOG} ${EXTRA_CATALOGS:S/^/-c /g} ${DOC}.sgml # ------------------------------------------------------------------------ # # Compress targets # # # The list of compression extensions this Makefile knows about. If you # add new compression schemes, add to this list (which is a list of # extensions, hence bz2, *not* bzip2) and extend the _PROG_COMPRESS_* # targets. # KNOWN_COMPRESS= gz bz2 zip # # You can't build suffix rules to do compression, since you can't # wildcard # the source suffix. So these are defined .USE, to be tacked on as # dependencies of the compress-* targets. # _PROG_COMPRESS_gz: .USE gzip -9 -c ${.ALLSRC} > ${.TARGET} _PROG_COMPRESS_bz2: .USE bzip2 -9 -c ${.ALLSRC} > ${.TARGET} _PROG_COMPRESS_zip: .USE zip -j -9 ${.TARGET} ${.ALLSRC} # # Build a list of targets for each compression scheme and output format. # Don't compress the html-split output format. # .for _curformat in ${KNOWN_FORMATS} _cf=${_curformat} .for _curcompress in ${KNOWN_COMPRESS} .if ${_cf} == "html-split" ${DOC}.${_cf}.tar.${_curcompress}: ${DOC}.${_cf}.tar _PROG_COMPRESS_${_curcompress} .else ${DOC}.${_cf}.${_curcompress}: ${DOC}.${_cf} _PROG_COMPRESS_${_curcompress} .endif .endfor .endfor # # Install targets # # Build install-* targets, one per allowed value in FORMATS. Need to # build # two specific targets; # # install-html-split - Handles multiple .html files being generated # from one source. Uses the HTML.manifest file # created by the stylesheets, which should list # each .html file that's been created. # # install-* - Every other format. The wildcard expands to # the other allowed formats, all of which should # generate just one file. # # "beforeinstall" and "afterinstall" are hooks in to this process. # Redefine them to do things before and after the files are installed, # respectively. # #install: beforeinstall realinstall afterinstall # # Build a list of install-format targets to be installed. These will be # dependencies for the "realinstall" target. # .if !defined(INSTALL_ONLY_COMPRESSED) || empty(INSTALL_ONLY_COMPRESSED) _curinst+= ${FORMATS:S/^/install-/g} .endif realinstall: ${_curinst} .for _curformat in ${KNOWN_FORMATS} _cf=${_curformat} .if !target(install-${_cf}) .if ${_cf} == "html-split" install-${_cf}: index.html [ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} @if [ ! -f HTML.manifest ]; then \ echo "HTML.manifest file does not exist, can't install";\ exit 1; \ fi cp -f `xargs < HTML.manifest` ${DESTDIR} -for file in `xargs < HTML.manifest`; do \ chmod ${DOCMODE} ${DESTDIR}/$$file; \ chown ${DOCOWN}:${DOCGROUP} ${DESTDIR}/$$file; \ done if [ -f ${.OBJDIR}/${DOC}.ln ]; then \ (cd ${DESTDIR}; sh ${.OBJDIR}/${DOC}.ln); \ fi .for _compressext in ${KNOWN_COMPRESS} install-${_cf}.tar.${_compressext}: ${DOC}.${_cf}.tar.${_compressext} [ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} cp -f ${.ALLSRC} ${DESTDIR} chmod ${DOCMODE} ${DESTDIR}/${.ALLSRC} -chown ${DOCOWN}:${DOCGROUP} ${DESTDIR}/${.ALLSRC} .endfor .else install-${_cf}: ${DOC}.${_cf} [ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} cp -f ${.ALLSRC} ${DESTDIR} chmod ${DOCMODE} ${DESTDIR}/${.ALLSRC} -chown ${DOCOWN}:${DOCGROUP} ${DESTDIR}/${.ALLSRC} .for _compressext in ${KNOWN_COMPRESS} install-${_cf}.${_compressext}: ${DOC}.${_cf}.${_compressext} [ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} cp -f ${.ALLSRC} ${DESTDIR} chmod ${DOCMODE} ${DESTDIR}/${.ALLSRC} -chown ${DOCOWN}:${DOCGROUP} ${DESTDIR}/${.ALLSRC} .endfor .endif .endif .endfor .for __target in beforeinstall afterinstall depend _SUBDIR .if !target(${__target}) ${__target}: .endif .endfor --45Z9DzgjV8m4Oswq-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 10:54:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id CCA3F154C1 for ; Fri, 27 Aug 1999 10:53:41 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 94679 invoked by uid 1003); 27 Aug 1999 17:53:49 -0000 Date: Fri, 27 Aug 1999 19:53:49 +0200 From: Neil Blakey-Milner To: doc@FreeBSD.ORG Subject: Re: First draft at splitting docproj.docbook.mk Message-ID: <19990827195348.A94223@rucus.ru.ac.za> References: <19990827194255.A12153@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <19990827194255.A12153@mithrandr.moria.org>; from Neil Blakey-Milner on Fri, Aug 27, 1999 at 07:42:55PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I said, > Installation doesn't work yet, but I'm getting there. I mean, install doesn't work in subdir cases with no document present. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 12:24: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 44AAF15558 for ; Fri, 27 Aug 1999 12:22:35 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id WAA07263; Fri, 27 Aug 1999 22:21:54 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id WAA05113; Fri, 27 Aug 1999 22:10:06 +0400 (MSD) Date: Fri, 27 Aug 1999 22:10:06 +0400 From: Alexey Zelkin To: Anders Andersson Cc: freebsd-doc@FreeBSD.ORG Subject: Re: ndc(8) Message-ID: <19990827221006.B5075@scorpion.crimea.ua> References: <19990826100201.A33426@enterprise.sanyusan.se> <199908260834.MAA02365@scorpion.crimea.ua> <19990826135650.A44944@enterprise.sanyusan.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <19990826135650.A44944@enterprise.sanyusan.se> X-Operating-System: FreeBSD 2.2.7-RELEASE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Thu, Aug 26, 1999 at 01:56:50PM +0200, Anders Andersson wrote: > Making a complete patch was easier then I thought. > > This fixes the whole ndc(8) man page. > @@ -81,7 +81,7 @@ > .Dq tracing level > by one. Whenever the tracing level > is nonzero, trace information will be written to > -.Pa /var/tmp/named.run . > +.Pa /etc/namedb/named.run . This is not correct. I see that named is creating its pid file as usual, as /var/run/named.pid Other hunks of patch seem to be correct. -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 12:45:24 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp02.wxs.nl (smtp02.wxs.nl [195.121.6.60]) by hub.freebsd.org (Postfix) with ESMTP id E6E1015019 for ; Fri, 27 Aug 1999 12:45:08 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.198.227]) by smtp02.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAA5D; Fri, 27 Aug 1999 21:43:05 +0200 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id VAA40411; Fri, 27 Aug 1999 21:35:59 +0200 (CEST) (envelope-from asmodai) Date: Fri, 27 Aug 1999 21:35:59 +0200 From: Jeroen Ruigrok/Asmodai To: Alexey Zelkin Cc: Dani?l de Kok , freebsd-doc@FreeBSD.ORG Subject: Re: Dutch documentation Message-ID: <19990827213559.E39830@daemon.ninth-circle.org> References: <000501beefed$a5436e60$0190fea9@tazzy> <19990826230406.B1440@scorpion.crimea.ua> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Mailer: Mutt 0.95.7i In-Reply-To: <19990826230406.B1440@scorpion.crimea.ua> Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * Alexey Zelkin (phantom@cris.net) [990826 22:37]: >hi, > >On Thu, Aug 26, 1999 at 05:01:08PM +0200, Dani?l de Kok wrote: > >> Is there anybody working on Dutch documentation for FreeBSD? I think FreeBSD >> is a great project, and I really would like to contribute to it... > >Check http://www.FreeBSD.org/docproj/translations.html#german OK, dumb reactionary answer mayhaps: Dutch != German... [although people always confuse dutch and deutsch ;)] Daniël, can you bring this up for discussion on the NLFUG list? nlfug@nl.freebsd.org, mail majordomo@nl.freebsd.org with body containg subscribe nlfug in order to join. We were having plans about this earlier, and I am still up for it and since I already have some DocBook experience I am willing to help. Just let me know... -- Jeroen Ruigrok van der Werven asmodai(at)wxs.nl The BSD Programmer's Documentation Project Network/Security Specialist BSD: Technical excellence at its best For ever, brother, hail and farewell. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 13:22:14 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 9D73D15EF9 for ; Fri, 27 Aug 1999 13:22:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id NAA45332; Fri, 27 Aug 1999 13:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 2BEA81557C for ; Fri, 27 Aug 1999 13:07:10 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id XAA07846 for FreeBSD-gnats-submit@freebsd.org; Fri, 27 Aug 1999 23:07:03 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id WAA05556; Fri, 27 Aug 1999 22:59:19 +0400 (MSD) Message-Id: <199908271859.WAA05556@scorpion.crimea.ua> Date: Fri, 27 Aug 1999 22:59:19 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13418: Some manpages still not have $Id$ line Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13418 >Category: docs >Synopsis: Some manpages still not have $Id$ line >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: Fri Aug 27 13:20:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped few days ago >Description: Some manpages still not have $Id$ lines. It would be nice to get this patch in 3.3-RELEASE. It's hard to track changes of manpages for man translators without $Id$'s. Make their life better :) >How-To-Repeat: >Fix: begin 644 id.patch.gz M'XL(",?XQC<``V1I9F8M8U(`[%W[<]JZMOZY_2MT>\Z=/C8!/WG=>V="`J2< MG4`.D#[V=*9CC`"W8+-MDR;YZX^6Y(=D;(+3;-R=W+2Q+6>!EOQ]6EI:DJ6> M/<4W360ZMN]:D\K$K$P=DYS*\LO_^_F?E\/3$9I92]Q$E8WG5I:.:2PKIQ]& MP\%@7/%GZI8O)37QMV7/DDI-G.3:2R]K+J36;H2,3';DDA:B6[]Z] MHQS_-M`Y@0O ME^1O"V-50A];J%%7E.I10ZHJ[.\O?X/CBW_VIO\,;I#C^#W1$\GT\Z].G=7* ML*?HPK`WQO(5NI;+DH9>_6MC8Z0H)40*H]-/C=ZC?NNB\[*7"N2T*""GNX!4 M!"`5-`V!G,9`5BNDO(K6A]:N,W>-U?\@#V-R!],"H]/!Y>=>_ZR,4&^&;,XA$Z-U<2UIG-R>=%"DB*K MC1*Z&K7*V[SXC>-%^Y3PXA4I=^U(4H\4G1#DK'^%+EWG&S9]*C7UR,-!7V:] MJ?EE=AG<:=,[;7HG21#+GE*D",TJ<^PO',^?W-K&"I?5`S-FAR:9%*+_!!K1 M?RA9$N!!XEY`,+TBJ4C2FK+<5+47X3<"45+D&=^JI.HU5;6I*NE\JY84F>,; M22H\WRXZP]/WK?ZX==([[XT_HU:_C;J]<;\S&J'N8(A:Z+(U'/=.K\Y;0W1Y M-;PXJ8!5&I M!9'H/1^==<;O!Z/QR6>P).CXO'?RM=\9?QP,?__:^33^>G6,=K('U*'*U`HD M3JQ$;LYP^@.,<3*%*:K`%%%4)(F6WKK(6DEN<"312HHDM"ZMX9!PI-<9H4'W MD2C#J5DE[29'%KDB5W>0I8LG[L9P;X'+0!@M(`RPA7&EW1F=!B39R9&582V- MZ=0ME".Q$KDYPND/*,;)%([H`D=$49$C^J_#$4[-:EGG.:)49*U2;]S/$0TX M0@091RY:O?-6NST4.++;D`!'IT;IH355*I8NNE/1:3!=(UGFZ'!V=.NM;UYHO_/!>`/S,=58L3Y)=M5S-`3MK M1YA94`/(CS]U.\.OO7Y[`%B#@6@?P2UT//H\^CJX'.W/@N()<`_VRA;V2O@D M8]@CQ*L564;$E95DTBZ\"+\A0CP5['3;\'"PH98_#.NXBE.XJR'<`M(Y02:> M?*$00_[Y*S?5FL(+5_=7YU"*[Z^`5"JT2J.D:ES'DR2K/+2#JS'8^_'[#NDR M=-AE;X1&@^Z8M`B=$NI\Z/11KXM:[0^]$4$D$"8&?]0+&H=!-_BRT=4IZ5>T M+EIGG5V=#X)^W[G&JPEVD5(3G(`8?M(]V0*?R`P\=#)J(VTW$;REXWS?K(ME M0Z3$WGU63F_*AR@9P*U62)M-2*%5FWH]ZK]NB445'FQ#>H57H8;'%9XD&SDJ M?)RA7E83_03MWGZ")O03^J/SP>#WJ\M]JOK&MY9>?`&NA;*T;'SP>,0N57(; M`+X8``Z7#HR!6I%D`%2O-C5),`8)6=XD*$U93?<$2SKG!Y8$2Q_!CMZ8;P&F M6F88(JSS.`IGH)GC`EQ3"_[NT:2+IY8'#VU#/_/;KHA$5!@(3)!27!BNN:!* M0/#J=FYO/*+(DGZ3%X0KVO@:+YWU"ML^&CO.TF.!"XQ.:+S"6^]!(_<7X(][ M#W'27`.J.&6,R\4JI6I`%5T3G()0*,&1^L]S1-Z'(QXVX9KUV7/_Q2&*OBB<)Z)#?O5@%)(&+%'LBAJE"(9$DRB,8DB)(8J\. M2Q)G\LTDY2Z>*9$B>[L>L>J`;)1BA)&)+T\<#[4I$ZM2BQP/02K!F(SH>2[& ME%!#);_$7VCHY)?U"_=JD!Z91T%!@4P#TW<")FE_+9.FF]7ZEV`24R232:K` M)!7%J@=,8JD$DX`CP"0U9%(L)3(I(SZ1ETG0Q2R2/U"\PQHCU["7UJ1X!H5Z MY&ZYH@(`WF$BI0430Z.\8())VM^S%6,E.BQY/.ON%^A5,2UR$R=0'L!EERFD M$6,JL5B",G]3[QC*6BD%][4XKDF MG$R"*?KC.,S*+^,TTZ(>Q`C-#8]&78WBS`^OPM[D,4);8W@\;>I@9K1&4XI# MO$:*=2&]L8R1WORNL<([R/18+R*FPPQ.(P[\57.19=?4-XK/?N M186J`J#!=40`F4YB(PT1G17`>E!)F8@D:BV#)/PLME(P)K03GI/>:-`G"-&B M\L\:L=S1ER/$S2!#:\/U2)V?8QN[AD^X\.;6,$U2Z/72,#%`]S8)D[FV''HX M-$A]`9+/ M$8S?O#M"MNN`MN^.1*A`#T"*!C3@V7C(=Q!,"Z4#]U#SK&OL;2%S[=%1+7*> M;.:''EA+YKZWB8W4I2@%B7@V*!UBA<'3V-3R0B)2&8/G<@VFY,58D:3&FUSR M$;$Z]]Y"\,/YA9C-V5Y=%2V(Y/*(56QBV:8&39YG(SQ5-R0;[!=PW; M6QJL13;6:Y?X8E,TN=TYQ9A\U/.Q,47.+/@6(NP0Q\&R"8T[]GQI>8LR(13Y M'Q&J'/"IU6YWQ[U^=X".+UI]N?-I?(Q>'5^T6^/.,33?U"Y]8`5#QP'GCO<@ MV6SE.\2WB"X*HUB:(OF'??E24)YQ-V*:U9!<;%*C M;U&1?HO:U$C'E4YB80/.F622]^JXZ)QCO.T2'Y\=]SO_[C^\(4+H>'X,.H++ M3/RU%2$G_G-CQ!U MB&V5*"JB_!Q\(F(R_+_.4'#'`LG%J[!W#SI6.F`42T6S'64=6!(Z/VI()D&* MXU+6*U1/B4M3XO#\&RXF;B8=YO10(!EB!1YB9>8\(^9[><.\H,@)+6/ZP%/B M!&GHSH:#LT?N;I'C\IL6G`HDDZC$0P@5ZA]0*DBF-%N-)*DXT02MGH&G^PMU ML,AQ[;%C@4SD5=@[GA0K'="/I;;C2(H6Q9$$*9%X_]^S/S3Q?/\V.!5(/5&) M/.0+]0[8%R03]%/J35GFZ<>)\?RK-:6,JB>/;/V6WP%:>BR*7PD5+5FBUF1&V?QC72V.`X#BYT+8\RV M&OE9PQ6!\B9.IS!'?+\S(2MR1WT>OABQ2/"*\.-;)+HV%%Q]-1>&6Q3%MK5X M2(R#+\2[,)@:W4H)H.G)6$="7*3:3A^X1IXGHOG8M.]": M+NK&PL^!$3/^1%_>&'_>QZX9N5\\NT(M'LBNJ!`QN\);>[*+%T^P*V.H[RFQ MZ][`?8R4L_D%Z!(HD2?4P*D>DR2X$RUK`FO6J$U-:^HZ'W`0)45ZZ!ECA-M+ MXZE_6WH0XS,&[<@#0&MC3I3:$#-$M%J[F.1M8L\CV5,3!"/FW$R$.35%EHF^ M5#*(M0H@7:T*HY6HP@--4*!_S"UV(\7\;`7R!6&>7?5G$=$B["+I)A)!@%I< MHZN^5B2MHFBPF)1*K'$5?5N@SLT:A:NWI-+*CH]%T2JAPO[K[`CCSE%J.RC* MQ>0%*9%!6>NL/"4&!9-IAH-N]Y&]<`;BVBN>2+$.>T]XXM0&R.-D/.E)!Z,D MU8/WE"D51+$$F;)>ZLDW[>ER]'-0T8E/3$^8^N1!H-&G*=]!EX[GCTS7(KRE M_C'.<&G6LXD/HV;!N2AT4]3(W0+Q1:!(Q^F43KPBM#\)61'OK)4RGICQN.R> MC`>7HT>V'6O+A-_"B!5GGY]0@=J43.PZ9>P(I(MGV&7'HJB44"'_ M*BV1\H!YE+HWLBU()OCT#$;:[@T'>0Y>6JO@5!0YMI3(OZA&K#]@&"?O'303 M146&Z,]@U(SY\:-!Y[QW\$+%N4SR#W0N,8/U$<&G`SL%7$-<& M+9VY\S.^4BK);HC;>6WA'Y5Y>%44U](UR>\D">6@7A)_9]N:J6+<8$M:7(1' MSEH%6./'UX0]"7^8^7MK8%T\'6RYOEPK[-RZASK1M"1+QZH8Z8`L+',8+:VT)!8A*A`/I MB$HEE5L%$Y+5?1"ESFR46UW.LK";U;ASWN^,D;P+P6EX/MB: M>KN5V'OQAECM&,9X1K#3I6ZO1X@V"E%@U,X(DCP`D9%<7NR8/1+*- MZB&4KAP%.R#*W<:5ZPA.%"WC\6K!&L:3!KJ&)!15"(1XCI:EG M[0-SSUJ5:'LMT=9X?-X9O>]=CE`5O6IMYL'^P?5&HHV<>-`X3@S?)PWAPEI[ M]-&+,,S=J4D/AX6"RS;'-%FJ)6W;Z&4,A0[+18.SW.`FQH8B/!!J]O8JN8$X M&[9/437AEKBPZS?D#LN"3HGOZQ/?UR2/X3MZ8VY<#WMO10`6AOF='@X+`)?M MW@`$6L+C8I\+&("$#6E.3\`+QOG?X.54"5HV6/ZWH8 MK=!2^IBLZ&O+L!UV/.PS%S+>^ZF'BKZCLUWH==!0:+"N/GGN,LP]C9X[)\,_ M>)VT)X_RX-D&I(AM6:X'1O[59:_5'[QBU6$0>=US>P-/I#RQ[,K4,D@O+C@= MRNO:H4`F`#4!@!J*-(:G%2:"-<:8H MMGNM\\$97>\;<7LJU1/6GRG!=X^".Q/G!GMLR6+J=2./SD?,`(WT3N%0#&!1 MYIE@Z0)8.@IT95#!980!J2LPF[3&WJ;7`Z`$D1BFO5KK^V#J=BE(BH?7P180 ML,8W6W.=OT[BQN:-SBS:@LQFV,6V21";8/\'QC;R?SABWS;YS%1V+`JR*/N] M35RH;HB:RC#1P1=6)"37FUJM*<=]&DXF@=LC+'P(N*D/!4[=C=P"0F>9V,U= MO*:'(I#C,L_$K2K@5D6!KLPCP^MP&7?BD2DR>&2D89+`(:@&'AE>;X-6S9R1 M\A"/K',)R,&V#&B$UWZP=884H!8LKY\,)1&]2@BSTXR=[N`$6+*7&&'B([Q@ MY)L+>"0&6A.G&KMV*HIW%GF0=_CF8+M`9>6^OV<=:$N!9-<`DTHW2F_0%SH4 MUA<-?.M8AH>RWI3W(FESXQN395"A MD&4CNCO"#DP.MTU.1N;[UZR[:&\<=AF_%*'29DQNJHVX9MTE=\9A<"@_ZVU< M7D6@]"Y%3+*>\EU1W@*?^][,O^/\A;O8&Q"93S>.9LR_2_<8ZIF+L>9A_A_, M91"9?V>NP!Z%7@'P'X9=PGH`X\&9[0E](C/'-8LS16'V>\?&(GTI)$$BCG"2 M=D5JJAK;2Y5%QK:$8E"R]J#+`TIW,#S=LDOB57RL4U+ M1OX;Q+>&AW`?0H4U^5SN>[^V=<K.?_>)%+G!8BY_` M)FR[/4RC`FO'\ZS)\G:KSK!%J$EAYYNEX1+LZ%])L;.ALO&/XI"BF>]?D9BN M%"=ZR6`B7599HR/0*NNR!I4H$A%1RIJ`EPNE/@SM)4"RV=`=(D6(VO3R'_&V M.J0Z9=<;&#$SUJY#H`W/AQNZW4.1O=MY7GEXKER:']61&DVIREYI8BU^FEPP M3JMD3D8*QVG_B\TG"E^7I[6`?1\B]WXL#-_RA+&ZK:W/I%*P`=J_G(6-/I91 MQ_`=.QQ%8)P(=O+9F=GT$7)++:I&3A=X99EL MC@)Q]#%,0'@9+BR`T95MT1D5_BT(C_&-053W46OC^5:XI1M+E(*_HEJ])BNI MD['BD1+R1&2=E2P(HK4NAX/+P2@>]$HR+?@MCNJ<`ID4KPL4KZ-08<`EN$ZA M-G0NZFQ*E9&VJP&L\IHQY5PIR=P(-"0;/-8_!2'*W#4L@%!$\*+59X8N/03J MT8B65Y2'+&2_=X/O<2ZRQ[O(LDSG,I&>".GFQ]M2>"DN,FE'E,PUYO,T):.' M1M6\_<-JU"ZML#N'65&DEV^8/F'/\C8546Q/C]9N>"X$U:0*>P>V8Z4IMF%* MV(M/H>Y<'-H6I'A\U:R%KA2YI'"V&)*"+28_*9/)2JAGF^42JM9TTG@0WZ!U MC4OHU%A-7&LZ)Y<7+20ILMHHH:M12V@_CA[O9_?N;Z-.OWUT.21T5$E7\OZ- MWP34'->GAT(H$V>^=V`]T)4RA5X&L\F4BJS0P3^=]9/UX`TT-SGG!-XMREPQ M)I<-&`S'8`)H52<=+G3E6TO+MS#4_^ZH^^J>;1Q!-]H]@#.+[)%&P8=O$AS. M)2Q>:$W,8%]L."W-]>VAYHEE9I]GA^5`X7=LCV66BEM?"9:M(4Z^'H\>;DM% MV&GIP3U%+ZG<3%1(*GS]'HS?=X8?>Z/.6]0:]D:PV6VOCUK]S^ACZS,:7(W1 MH(N(#*G''7;9&Q&,N^./K6&GA#H?.GW4ZX:-=/L#^:9V^!'B+8UZ)[WSWO@S MW$J9T9+5=,,\E?]T=VZ];>-*`/XK:A^+-KXG3I\V%V>1T\0I8K<'!0H$BL4T M0F3)D&2GWE^_'%Z'-&5+L8Z%GH?:&FH:COF)=VJFRV/W#D7G/9G>WUQ\_>'U MS`Y<<(CY[GT+OA[\()@]9_F!'P6W">4#>IJ6`SLS2=?H#D2;@I=%]7;^IBI^ M.D[H"&[_FHWS2+V>]][JQ'\^G#L\2X#,:\88CY5H1]`V'? MPS9K@+F$8E4_F/#W$;[<#6_O=7X%+R]$E[.SU9J.*3,Q-N_&N]`]$K)H$AW/ MOUK[*6Q6Z+CL0'=BMIQ:ST)75[,)&;C1P1U)YBGRLV)]`$J4!\B,8P0-I*\>57T"A%EG^U-E38K"DRV4%Q:+:?6L^D6,?45F50 M0)'>R4BNJI@E@[BSOB5I0!IM+*4%U9I+9;?F)5+$>8-VBTXIV^!^\7/WQ&PR ML:;%K(;-(91%`35V3T,SQ,?D]RYDLXCXC1(3!E1K)*75BI=(L"O8Z>=VUVPF MD:))J\C/<65:+`L+/?3G"M(2&$0.9<$AG6 M,#0RH3(U9C:%!@H/9R08SJ6@BZ]8U\&`Y M%!);_Y:$J+#P4T-^)+_6.\?U8=QLN\CSK\9+V*QP<=E!:VC2TGH6K!K<=:L, MW*S@CJI;6)BOE+0+4\,MHC*A.BRK351)Y9`5M(J]NA:*11[%X%!#"**Q5HSN M;^<7YMFL87["A*K\I.6(GTC:Y-=IV_R0JLFO7]<04N11Q(_=E+QB\IJ3="Y% M$@>4X&YXR2+/FF7'+:BV7*7L1N1XBK%EWH=W7Y@#ECX&IS5-;K7-J7D6;FRS MQY3X+XI:8LID]ISLAI8UW;-E;^G:,KMOR]R=&XKU;"M:O.KKW;+B[BTS^K?, M[."R4CU`7H&+U>_=EH\0Y/.C4S?-2PF MD/D#P%C/88`7AR]&3"`3KNP"^0,AW`-N(?9"TI@EBDR:^'>1*H)6%(9.]/J]1MU.;)BC3)C.=?K544 M-BM>7"Z@A=I$K6>RJFUV!AFX2<$=U2`*P?ODL?]@;GC2YC)(7MG?2])MY))E MWO0X1)E0K<9IRQ5"E>2@:"U"&JH6R+KZ-I%'P6`$]EP2-?H(@P@+L^3%"^=S M$O#$K017)(W\0Q_<0@:"UM&:HFP5Y=QPY$'FZ"XJ:$!N)K M&N9DYZADX3=ZI(!E7XT4MUA18J*#D+60I=1,.H.ZSO/0O^\F0R=D])X$DRT? MD;1(R5-*LIVKQ>S5^-=&.0D+*J*2=FM:(J4$,*1I,:NK1O$LW-CX/=7!F>)\ MI>5MW`3>)L$I$ZJ1TY8K="K)P-OF"C3*BV^J\M5]A4DG;B,X17Y@9=?H`$K?\; MJA:^NB;=(H^T8-K]Z"^#U,_5,@H[!SE[]M5FSK.?/82S,@3#1@]M20NJ\PMC M&U^HCV,-P-ULN\M\HCOHA9L'MRB\=CH0(3G7VT8(FQ6T+CL8&:M.VH]"UE=9U4A`S>Q93S+]9#CA:QC?ZYHT4++ MR=87@&\S2#RQF`UPZJH9>+]0J9IVH8Q@.9:K* M&)L+67L+/\M>DS3@ M(:F2R&.N3"U:_[3^H9\';IQDIEO#9)A5@Z5XPE8H.GXI2KK#WD<_!1_.;1ES M2'C3Q&H(2)&GITI.YVZNSZ%-.O7^LXS6+@?ID#MV*4M_72L@2`(,J9^N$17P M.MMZ3))\$;1R<#/$!?(DOP\5BJ:<+=5#G:A?`06N)!YI@_8O/>8RI#_@1[)1 MT!.L:<+<^R#4S_?(+`[WG!;#U]&5-_3>][U+,O.$)ZC;L^OQ=#0^&U^,O(N[ MV]NS\>7$Y8FGN/1RDN7ZJGF:MCUO(RI^BV+*Y7)4M2[BVJUAY5UR%<8ALM/1 M9`IL:;O!`PJ]C>X3+2*2!O+[T#`WLB_=UVF#H425)-YV[H!/?.8Z@+_HQ_LX M0\LD5>";^*WQH53H-IWEOE';KJ['?X_N48PH68:Y'[T$_//0^(RLRX\1A:EL MD,BOE5-\"!7297Y7]6MC2,>$5G-T-@5-9CBDQB)DX#6FLP4:;62%,_V.06YZ M=O/%Q>V)M6/P>7!N..O2[LVDJ8P;OQ9#RF,67JI-QY-\>8D[.$,ZF!N=>]5; MV7@P-I'9OM5L>C7]BF!ES*UG,(!_AW)#9^99VE4AMQ`*DET)-">4#K2$<):^ MK5P4*@T3S-[S+A[X2+CXZQLQ[FXO![;?SXS02291+O<>`PA`1S\.5M"%^9=N MRX2Y;-3`+M5\%UHRYM,3O6FN57"Y=XMBZ?1Z$"E45P@JGI:N$"*OC?K0/2VJ M$#"TN!Q-P&\@]_UV^E'[:?P&<=PDMV>?%IMP=-MOQ7X^/^H?")DKZ]*#!F$I ME"V_Q%YV8?_H!#O-MU04K:*@Y55JB>HK1"&?B%HR/IO>\KAL=YEW/KDL*'+X M.`I[P^,6B1LJ>M.$T@B8O5!<<&$7_Y"/KGGQ&PJB\'M%?4SS3X M)_R6QV5*YQOJZE"-U4XS2GLKQJ9_$.&DA*R6(R#\]2ES[W2LO!9OZBDN=*2] M[^Z=XRK;XF6^;#WW;XV9"F;`K'89K(!=#X6`6_7]04DH%%3)$ZMIW/D\+ M688C%)Y5Y;CSYO)2/>-7*2&H`9*_.D^76<8_#UW@1M;E8S@+4Z&,Q+48E7;8 M`8&3S[VV$;]9Z^!R/_[/_-G%Q?1N M[`TWFQ;VRP/:I-)_#[,\@ET:?'UP"EMM*=_Q&K^`=;TX1=4-'BJXV^8A:T7G M:VMB1,-JOFGY[&$CALB)-PGGU/#)L[\(T^3(\\ZBR&,J&?U9&4E7)-CF-)I' MDDB)%V9>G.0L#B"3UR3_Z#TN2_;S385O'>-Z5EOG`%\1$^;]HSK+PE_QN#+)A0R7(W&H)F4F.1JUO0%9: M%N0J,Z<_#?(Z4X-"<=T<;)?YH])3`Z.W6%!Z1DBMOH#"SRG9`%ZV.IU())RO\.]GPU$\#E##V.N MP=>(F"H.V4QQ(/>.SKY^NCV_&X_X9/';A3QT_V"^[M*_A[.I6XI^,5OEK:'7*/::D;Y,R7:IE M\0XL=_)MH0TT"H>UCI:E:P2F]J[OQ='1Y#?&\;NXNSF[,$WHR=SBE-X)O M2,B.W(R6&6P$KK/6*N]VVW#5#"27':7;+6P[%":2;4YB\Y6W6YMZ"%2OAN.4 MWZL%\?@Y<#_:`/0:S9+XB0Z? MY<7!>Q6'!:7K"3(:BE*+(@96!W:8`%&/4E*UQ%3#D&IX(\S8>SV&/N98+/[R 6GN:_-Q=WXZOKOVE?\R]Y\HPHY@T!`%&/ ` end >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 14:20:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 679EF155D6 for ; Fri, 27 Aug 1999 14:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id OAA50799; Fri, 27 Aug 1999 14:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id D656315531 for ; Fri, 27 Aug 1999 14:06:55 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id AAA08683 for FreeBSD-gnats-submit@freebsd.org; Sat, 28 Aug 1999 00:08:34 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id XAA06121; Fri, 27 Aug 1999 23:56:33 +0400 (MSD) Message-Id: <199908271956.XAA06121@scorpion.crimea.ua> Date: Fri, 27 Aug 1999 23:56:33 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13421: [PATCH] src/lib/libc/sys/*.2 misc patch pack Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13421 >Category: docs >Synopsis: src/lib/libc/sys/*.2 misc patch pack >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: Fri Aug 27 14:20:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped few days ago >Description: - first column in most ERROR lists is too narrow. Normalize their width. - few $Id$ lines moved to bottom of copyright - mdoc(7)'fy - some visual corrections PS: I have moved ERRORS section of sigaction.2 to better place as I hope. Comments ? >How-To-Repeat: >Fix: begin 644 libc.sys.diff.gz M'XL("$$'QS<``VQI8F,N@KGJNW)=\&?JVO+?=6^'#1V![KM!KG=+"7BY%-1)5'[XE ME%:KU?CY2.]V.W5-K^NZT%N]9JNGZ4=8LUPN9\MTL8P!91J]1J-GZJ5W[T2U MU:ZT11G^=L6[=R51&X8E,5M)L;%\Z89BXWMS&035X9GPEL)R'/P(X7<8E(.D MJ@)O`@$=!2&^FJ]L9U&*?Y&!@*9$($,1>D+_.]6V73NT+3:'JG$IYRU(Y+E`JUZ:/V5*E#\Z%K&GS@A-S(I>?+4CQ>*'CN\J2*6JE: MFZ[$9#"[GHS$Q_[%]0#)RK^99FI@*ZYPY;WT`>(P\EWL&"I,!P/1OYB.2T-F M1VL^EYMB^#'N^B!#MG,,V4YI18Z,ORAV,^M&5QA:KV'TFN81UD66W"K$/&GV MFEI/[Q(&>LL@$.@#00"&Y&GDJB7Q8`,G+BW;$?:R!S"<.*(:6K>B^F`OPI48 M?!I?7YR=7(Q/?P%$#O_X^$C`BY.O8N"+P4G_[)RY?R&#N6]O0@_8*`#VN0=> M7=1RA8>CV22+5Q`4AA=V?1"O5@ZO5DIKC!=^02C:=,6%`*\.%3)1AV@:X=5I(5ST%]&RA"9@PB*)<\=\+A>*TP>3R7@",M&G-E$C MH+3C<+'P0KJV7!S`U-\#Y:A_.9B-QQ?CT?LM+$?CV=EP`AV)N;?>>"XJ,Z6Z M-A94W?AR:3]BIZX7`LD+VP?]X?E/>90S'63`+DPTOR68S1S0S9A.!7,J;^VZ M;J!0FIV>WCG">@KD&.[BT)@Y(Y?K%\5 MG0@C/RJ,6G5=$X:!,!KM1+?FB@",;6'HO4:WUV08NPV$D?[F]"I6XS7N6=7: M/SN;P$SV/_;W`);^.+S8JUQKYY8`GDG$CA1K1MW6>`'0F[0`T`?QV\"!/U<; MACSE)^G[GJ\,C(V46)*D475\^YZ8NK)>I(IDV%24^L9+=8U&NF: MV`)#_CS%*ED%8[D+-D,CG^S4!\^_0S*3F>6R-U)$[GQEN;>TK)18*_EB#3;= MKG9"-OHQZNDGK#XD%UJ#K=-&9F[.Y_]BD],_/46S>"HM'ZQQT-5K.R#62BT` ML+FI^Y1BF#`)@YG#CS=/Y`&PU9!5'8GD+!WKMAAS+.G[H/1T<]+3S5#+\J.^ M*>DPZGH3'3;PZS1X![59@O*E0(9,H7=!@'H&NW4=O:*W0(C@P]S5H`#AV5=Q M??YY>'EY/>N?7`Q*U0I@N/525*`*O^M?70U&9R5DK>3=:'P]NAB.?@$DD!JQ MMIZ0I]#3`_@B%Q\`*VD#6@RG]^#"$SJ2#)Y".;]@YVB<[J-QNH?&Z1X:IQD: M>5G16'PZ!\R84Y[7Y_V+/X\48 M7*KG@Q*IFSF1!(&):66)I.?$>&[H:'7IX*RBU05U62"SA6)Q;.B])HNCWB07 MB3_V,X$O5009U+/ASE3SW.F MGM#*G$G/RM8RZYHN]$Y/:X%G?D1UF3.30EG.-.-8"\>[NK$*8=T),#E4\2!' M_FLQH\%FD]'8PXQ;H_QQS(BNSCG,YL*33"^9,.B>['-[$E[T/:^8\$+<]2OL M?D4K,R-_V0TR&%K&\L\52KBQV3--YD;R^[K-@UH2Z^]C2GS_C'V[!]?_41SW M?S^42UUK+9_E40I@Q*`#,G>?;V48VFM9#/9Y"@ZR@)%C`6.'P#G-MI(+^ MB%-O\^3;MZM0O)T?0RUP7+&N3G\;3"XN3!-Y"YP2Q*QR[=KWT@_L\`G?G()" M`*?'M:V:$'U@7FH1PZ=@%=]C^!2GH:%7P*AO:)5./!'B8M@_&5X,9[]5Q'@B M9N/)3+P=CDXOKL^&H_=B-'A_,7P_&)T.\-?Q[,-@\FDX'1R+_F0XQ0+#D>B/ M?A.?^K]Q<^/KF1B?"R@HKJ<#?AQ.Q71\/OO4GPPJ8O!Q,!+#<]$_^P@-G<6% MK\;3Z9`)@5?5G"W$)GD:'YK>-+T)QBM'\ MS^\'L]GPA=>/(P/Z]&-VU1<&+==SP.8'..AOC$8@'5@3=O!@KW>T9BAR[7\;DY-'8<*(LJ`L5T6! M@3V_V(:(*563C\\')KT53WJF3#+9[9[9X,FF[6SZN\^`>(_52V0Z!,DFQ4^. M>+W0J*5M:S`9\5T&1\>[M8MQ3M+.7^&?9"A6D*JO>U!MIU[*3CDV`;2>UNF9 MO'71)$>E&3LJ;V`;>6@'I9??WA14$$?QB@4F&L2@,-8GA M6:5$@4;Y:*TWZ-.LI*OD,Q)ZJ0J-0\%%[;A45H_'M8SO,%4TES#B%1">])WM M/X4P]02]>W/;"D%<'VQ`/!N;!>IH,D,O`SHNBMYR83T5!7R&@!.XB(#=A;<]]3[T`S&QW+N'=PF7331,K+_*/*^*_+3>RP(4@^ZVMJ=:A M2<^)5'X)!RV?@E"N2VS)8,@GXO#Y66"($)H0X__[Z) M><>&@8?1K5U,H"W3^XMWJ;,4(\MDOJO`1A>32$#)ZV#$=Y/]ZJUR&69I-'H& MQS9,6@S,.+U,ZF965',]42E5#Y8 MCS50/R$0=:"J!J2#F?=@0<.^)":#1PN9-W)HT;&4@I./[<""CWJY^;K5+Y^YNBL2H# M6(DT&UAO`6M>+("]?50(?!=>VD*);WUJKQAPPY`)*K=OX]CT(VRV3:F/VG<0\O*!4A6E%S*(P7<0H MQF$Y@4=.(J<^9)BU(E:X74:O,]->*O^AIO(3'V-(]3'<<8,V#2E?0!TU)Z_1 M-M@]?FB!!.%ZJX8?Y.>.UEQ8@VUX=R-O27F'D0U`1J%P);,6M(\6,7$9<3@, M041NS/\*ZL0._B?8>85H0N[XQ4I0T8GZCQ\3E:8WA=9%_\\P$M6W541I/1.L M8(ZA:153E.%ODX6Y[XHKD.#J!^FZ2,'BH^>XB,5Z"&MBO]5+U8:5$W`9D4.E08N>Y+^7)]`S4VM[?T:5Y3!V4 M.V>Q+"K_)NG[(#R-'#R-#+6(4/(M,6DQ\&[0%BTZ*@T":;M4@A,L9!W"J6T@ M3O"WF;@J.4]0@">(S:!A$$I_"0L-C-(/PJSS%\^[:-0T7%(.EV0$H-@6"E"L MJ(VY7/^O0R.A.D$D?O,\*ELE,\@H)Q)60I/6PR*1<3RK,%2X[]<@HJA5:/"W M/4@TLTCD2F50:+)9TNZ2?'0+1<&5C\7LQB1]OP8%1:U"@;\]AT*N5(R""9ZW MDH46R4*K4!30S"@*!>[[-2@H:A4*_&T/"JTL"KE2&10,4V6NT&*!'T7B$+E% M:J6X]X-8Y/,XS!S%"HWX>VI@-7"G23-`\1QA"PJ/G7()(@T.1[5-TDYF@7B$ M/A0M!@S5]8MC0PFM!(/ZDLYM0X!SK[7!;T_B0;N%:$O0:/0:6G)(I,6'1%*O ME6NA([&ST8%PT*\<75?/6V'UW7E7P74SG7?'=HO95.*.#P=CM7PP5HLIQ3GG M1S69C;K6%#JOM;@Y#S5QRG-E$HXW>[HZY4%[\YU#>_,74'M[9][UJ-%D.SZ. M2NS=C.__D%P1E6WX!\]XK%4+MB?3OI".?CD6KWJT#?>7O'GRZ;7TN;X3>I@&W M>-_ZD1L*@<+@1C&F=\\O5= M40<.5,\O7DUB2HG5[Y+#!+2W8&A":^!90K.3K"69,EDF3SQQ/F[8.G2XZ?)N M3WX]J+;==*-OZK=4SQ2=$Y<`O@1A*@AQ[OH5D"M:&7/^L@VZD!]^19EJ+;,@ZAC_3VPX^N?C?CT^NJ*TUGOI.]*1ZRL0`58I8O1M:5]&_D< M$PVB#497B:XWP;>.O*WOW((B/:KG5\#M)M$=];R[@=PP,F"[>R(Z3;W75%C3 MMB']W8^U^XWLZQAKG/]OXUUXMFL,M!>Y!=DNW/-A(S5_GX'>26@EJ/EY#]24 MT$Z3AV&24/+'ZX;A_M1A8`[AV?AZQGV-L"_D3FUS6G,%'5J?ZO"JT=)I7/3QNG&M?^JX+L^'%X.2&'F\:PUBB>=@D[.Q MU)F@C+-]AR5H:!T>6D??%JW(W18NS'9@V<+MXKVRQ5-1K&SE%DC7>X^4:&,GPF?IZ&P_`Z$9/ M,\0_PWG6_R*/T*S`@E)N-)(SD0=]0H'_T"_DCAJ[3J&9=PJ_;U;8+>QO?!`3 MY1BJA.91?S2>7@P&5Y0D.@X$&RW(_!Q:3#H$(D8+2L>0[B+-6J$=?G+[4+VX M@F*+]Y8CUM(*(N4E4B-Q1A1=1//;:'PU'9)9M!!_M=VY$RVD^`_*TE[]%[X. ML2G.Q:+CA\U8%\PM$"^U&QSBH5X7]^=)^)!.`6ZG\U0!9KZU_(6#1"8Y&&?W M8MK_/!E,9_T)J%V^/,1SU55!T)@?;>AJH<"^=2WGI1?O#%GAL(9*)VPWZ>=& M,O%TDD1^C62`-AXE;:'A+1UK$\A%A7XGXC@$K%5T393;.G[@#$0N=+`!4XU5 MZ=M,5847),5OW1&PL M/S61U9U1^52L/7?TI!G5&1;`'*F$LY(SY6(A'0PW/?$9Y9C;=A=#RKOSOV(6 MGKIW`G.M,O*D>)C8'$;BBM^E[V'*GK@E#\+GMYA]^A5X@*[&TC0-.,1Q5,94 M=I&:_C;=/PXU0.Q.2=)`.+#H#ON6P*^XXU?$LQ6EN,[Q MXQY'H97&LW-ED@T$S"E6?@(?GTXNF@`,\-Z0>:RVR#S9$DJT+C"_=Y'<682] MP-?(1:S_S$XA5L?(02%8IYV_>"X42X"'15@!K_,=;WJ< M2QXKR>`E6E)\2TO^4?25=IG%ZTRZ1)Y;Q'?JA$^7S[,F\0R2;=`,5VKTSY]H MS=#0WW?;30&W&?"=/V:\P=1WQ;`^9BGDE0ZMEH<5RAWH4)KVI>^M48D^^':H MW+(D;,,^5*+Y,`%UU\^@E>DE;@8>%MX]9;AS/G.[XC9IX@;@6#Y[,+/;$J7Z!DR-P,T@ M6M1M:8G!Z+GP2WS?TI7O-R?=<@.Y_I0$?TV45F;KATT8F9Q"2"4N7 M3_`?8$IF4&J;9B0W/\,4M\2C6S:>XT'SW@_$V^OIY!_7XUE?=7WK>]$F7^+] MY(I+P+3-,O.97$ZGB"4*]BS+__A,U<>C4GF6F[\##>RL6W$#Y^?QJ@V^==JJ M&+B4/P_,WHSB9'EBV5%MQ'?Z_/,'N)$M?`J[-U$PDCV^R96G)GC-[B2V-T7OOQ($\8^.KYTV@Y%IY0<\5&Q M=5<^0"7L$LHG>C"]D^T3[C^Y'CB3[(>@?B+U+][:-5FK<(QL(#5\>5S&E$>%FJ\M!0K:%Q3*;PER^\C0R:2!%$]Z5DS&12>$@[K%J[#;`B MXC8P3?&Y)EAWDY*9XTE<##_RN2<,V8"^2=39@X6<"*:^%87>&G3OG,_$08/N M'$]PR?E=S-#87L"L[*\)A8WT07NM\202+@SJ-%<`53IT!JN:!#UV(X-!1%<0 M+R.GPA$32@#,7LZ->^GC^-Q=!>@'AS!SHS$O/ZYR4+(_J`FZ=;P;RTGE:7Y? MD#1AQR\^BZ3H9$G"QSURE![#S!5)I"C=BS5TOHLB#A*K%>ER^O[SU6#PBY@! M5TAY)S#6YX(*0^+6`(MU*W.%/_6'LSX8D%">KK+`10N@'S"%Q7&51"PN;0WI#"]**QZR^H-8KJP0DM%B!I$?;*37/]W%8=5 M*^-1]'D.'L71?!W\?WM7VYLV$H0_AU]A]5/;X`3;$$(BG8XK28,N#1RDIU;5 M*2)@$E_!IK:3-CK=?[^=F=WUKE_`H8G&@QV0SRB0S?%*\'[@(+%;\& M)GN)2[`K5(1,&KIT6(B4E=!)%^3GLFP,Y7:`3`K+'[0Y/I-&*D(EK8#5(+-# M0\:UXKZ-MI9T[`^/+>7+T22\N<.L8#PXB2@1=C2YAW(& MO`\^5X4;&OH1YP,N*^&&+@K6-7$^T!H1;MH,64]V<3`,+>W*NW_Q'-C*'E5$NA1LXE]*\NZ%"NA1JE$H* M(IH-R;D;IFF7"!"VL"H[&!KAB(T.%@S,!L?588^^HDZ)E-5+V$+8(X'!)^#4 M)='=-=+GYJT<+T:G;^"-OWUAF*`VB#UA>]8<.GC(-Y'%`.MSWK]X_^'R;'A1 MW`UU.CH=C@9OZ&CD@M+9F57E&."1;\<)%8'$VA5XU\<1BZ$?8\Z2TJ&=^P6-FG'VK`TJ$,DGMQ):GMM)5W3K,(U,% MC0:A=^/Y;):S#YQ;\%0@WP'[X#ES_=#[;/P)L0;AS602SHQ>.+D.W(71_6+< MWL]^!>_TP]Z*/[#/:KK*.70CC-R%%"3+),$F,?-NPD`#A@H??2:$+#A+V M247V'#9Z;W+OS8RWK)._9&?3@CI$$?O^F@%+WQ4\.+O%P]5R\JT2#1>)4IKN MK?!90/]%?^1X.`369^N`S7I*GB4"N'6=5->(9#?-#Z@J?C*%$U&3P/@:L$Z* MX3WKZC@TSE1NA[K1]Z?DU=CD[\"T&?:]]K^GF'R"]UKC;).A8=GHRS@D7\;X MS=E)#^@FKX:C_F#$)+IZU_V0>#=H:+:-KMBQ>5GA?$E$*.T,S,B>S(_DQX)Y MX2CS0F^LSH<#D5N^;CZHD@L'U,]YL/T\V.I]KL?_^.1RV!UUW^7@'O]QMW"K M.?'EB?'(?2+U#-H<4/Y08G_(=M#G`G<";I@+VI/\W!>>9#YL]TXWS@G\Q_OS MDU%Z7CQX[J*:]"MM_.(SLGY$3DF=3`'^BSPKVX<0XBQC=C>?`)7;3[R7P/LVKW,]U#_V3\Y["L;=BOB\:.#2!72Y MG`AGUT]PW-IO=*#F8;-%U"R4;)8T43[X@*R">PF;5*FT:==3]3.@XS*ZJ3UU M58FN+\J1JI5.\)-/..WU#W6JMB65%*^J8@>58Y>VQ"32DK;X58XUQI;6F'0K MJ3-'^*1DQ>-\G_V8;I"7#2JL813XH9(>3A8Q,G_FZKG(.'G&C4GHQ?O-+HQUNIH,J.RDVL^/SLP/XF0 MI`7&-XO,LJF&BL9M&6#5;,!:WI14$)`O$\QC).NE&'^FYZFW\&+/W9`(PU," M;G\1_KW?9H;).KKA9`%TF.'=-$YD,OZI&3OW`9NK\-_+U]'DZI:!B1TY7KU\ M=6R`/Y&/SW\&YR%*;)'(EE6WN8.!NQ6BQ.4L8V)IT4DBE#Y0E&6DQD2 ME+)N2"L?8J39XH'=4+S`.07`W1OC_MO?^^?G\)SRA_'E8&C(Z!#0U(?NNR%D M;L*R(&[!EJ#8`T#,EWLRM\6:F\&9F4&,*O)GK\9;33.4'CK]L9+?*Y0%NPA[)C7LH\C$UY'457T>I8T1O%*56E-3%Z^5.@(C'7E[C..0FVDY-@IIVB*EYJ.$=5 M//D'US)ZZ]^OF1W62"R2H!BVJ.Q$TZO`1UT=[^S008`T!U20KKK$LC.!4%XP M_0QVO(H\J>KPI>/)-)E1?\H/.0I,8LMR&DH-'AS9DJNWC5R]/&G(:.BA>+0L M8VP?1ORYLZB.@7S(6H^%8'+\L%K[-;E]P]'@P>@R+X]*;Y'/R'`9 ML/T%0HII"O52-0/9Y_N#1%T2/E]=E&9WS'>X2G*`*E9=,\1@2.*`D%>'V>]I%*6 M!]E2EE'U3Z47ODR=:V0T3%[=R^CK9%75!RL?NOR*)F1%R/*+`LCRE4QO)"'; M$50;!YB*?-`H`BSVKY59D7Z\1(+H85E9KH@7L1>SNU\'"FQ*5:GD(/)'Z:S+W.#'U/D23<%I- M@3DY=GDWAI26-,JON%FI#3;PAG/D,(TV$_>%VDIW76Q,]I[#2:Q(:?R_8AZA?N@AI:3K5-3X1C&[$2'A'4F2N9\Z!P_,1 M\><\1%BCR]XYV'-4!AUGWVKL=RS53['ET_=FQH"M1)!P:B5LLN"F^#CNCIB, M$K=LO_/!&E8)<)/!2XDD.@@[P(G4[F;!0_^Q/)`O2T7LYG`G1W0/53S6%<#%UZ\Y.R`MS$ MA02;0V7[.D=66VY]J48":HXE,B0+Z\M3SZ+F/LPE("R^S2H_J*D#'M M^A[/]IVLQ=VQR)/@/KX&$\$!MR.]CCBQT<^D/(7.BO/,+>-1T9'6'\@8*^/ M3?A[]KXQ]1VI7A6^&*#>?/^MD)%45QW:A>#I>+$\?,3G>3:%"BA)QT>@")=. 5)"(!]$UQ/.P/3VK_`>&SHW_9F``` ` end >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 16:10: 5 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp13.bellglobal.com (smtp13.bellglobal.com [204.101.251.52]) by hub.freebsd.org (Postfix) with ESMTP id 47A9714E0C; Fri, 27 Aug 1999 16:09:59 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from localhost.nowhere (ppp18333.on.bellglobal.com [206.172.130.13]) by smtp13.bellglobal.com (8.8.5/8.8.5) with ESMTP id TAA22081; Fri, 27 Aug 1999 19:11:51 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id TAA38684; Fri, 27 Aug 1999 19:03:41 -0400 (EDT) (envelope-from tim) Date: Fri, 27 Aug 1999 19:03:41 -0400 From: Tim Vanderhoek To: Neil Blakey-Milner Cc: Nik Clayton , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990827190341.C35482@ppp18415.on.bellglobal.com> Reply-To: hoek@FreeBSD.ORG References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990827013021.B47771@ppp18415.on.bellglobal.com> <19990827152244.A7271@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990827152244.A7271@mithrandr.moria.org>; from Neil Blakey-Milner on Fri, Aug 27, 1999 at 03:22:44PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Aug 27, 1999 at 03:22:44PM +0200, Neil Blakey-Milner wrote: > > Introducing a line break because changes you've instituted earlier in > the line cause original text to move forward over 80 characters should > be avoided, as this gives the impression some work was done on that > text. Please don't reformat code that you're editing, Neil. This makes it difficult for the translators. You should endeavor to keep your changes as separate as possible from the original (see, for example, the style used ("that's supposed to be used") with mdoc files. If you start running par(1) or fmt(1) on your work, you start making life very difficult for translators. Thanks, -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 16:21:49 1999 Delivered-To: freebsd-doc@freebsd.org Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id DD9E1151DB for ; Fri, 27 Aug 1999 16:21:43 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 47078 invoked by uid 1003); 27 Aug 1999 23:22:37 -0000 Date: Sat, 28 Aug 1999 01:22:37 +0200 From: Neil Blakey-Milner To: hoek@FreeBSD.ORG Cc: Nik Clayton , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990828012237.A41324@rucus.ru.ac.za> References: <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990827013021.B47771@ppp18415.on.bellglobal.com> <19990827152244.A7271@mithrandr.moria.org> <19990827190341.C35482@ppp18415.on.bellglobal.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.6i In-Reply-To: <19990827190341.C35482@ppp18415.on.bellglobal.com>; from Tim Vanderhoek on Fri, Aug 27, 1999 at 07:03:41PM -0400 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri 1999-08-27 (19:03), Tim Vanderhoek wrote: > On Fri, Aug 27, 1999 at 03:22:44PM +0200, Neil Blakey-Milner wrote: > > > > Introducing a line break because changes you've instituted earlier in > > the line cause original text to move forward over 80 characters should > > be avoided, as this gives the impression some work was done on that > > text. > > Please don't reformat code that you're editing, Neil. This makes it > difficult for the translators. You should endeavor to keep your > changes as separate as possible from the original (see, for example, > the style used ("that's supposed to be used") with mdoc files. If you > start running par(1) or fmt(1) on your work, you start making life > very difficult for translators. I thought that was what I was saying. Neil -- Neil Blakey-Milner nbm@rucus.ru.ac.za To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 18: 7: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from vaview5.vavu.vt.edu (vaview5.vavu.vt.edu [198.82.158.16]) by hub.freebsd.org (Postfix) with ESMTP id 9367014D1A for ; Fri, 27 Aug 1999 18:06:59 -0700 (PDT) (envelope-from dglynn@vaview5.vavu.vt.edu) Received: from vaview5.vavu.vt.edu (vaview5.vavu.vt.edu [198.82.158.16]) by vaview5.vavu.vt.edu (8.8.8/8.8.7) with SMTP id VAA08952 for ; Fri, 27 Aug 1999 21:05:07 -0400 (EDT) (envelope-from dglynn@vaview5.vavu.vt.edu) Date: Fri, 27 Aug 1999 21:05:07 -0400 (EDT) From: Greg Lynn To: freebsd-doc@freebsd.org Subject: Book opinions... Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello all, has anybody here read these books? Unix Internals : The New Frontiers by: Uresh Vahalia and The Design and Implementation of the 4.4BSD Operating System (Unix and Open Systems Series.) by Marshall Kirk McKusick (Editor), Keith Bostic, Michael J. Karels (Editor) If so could you give me some feedback on them? -Greg To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 18:40:22 1999 Delivered-To: freebsd-doc@freebsd.org Received: from picnic.mat.net (picnic.mat.net [206.246.122.133]) by hub.freebsd.org (Postfix) with ESMTP id 6B7A314E38 for ; Fri, 27 Aug 1999 18:38:16 -0700 (PDT) (envelope-from chuckr@picnic.mat.net) Received: from localhost (chuckr@localhost) by picnic.mat.net (8.9.3/8.9.3) with ESMTP id VAA13099; Fri, 27 Aug 1999 21:31:05 -0400 (EDT) (envelope-from chuckr@picnic.mat.net) Date: Fri, 27 Aug 1999 21:31:05 -0400 (EDT) From: Chuck Robey To: Greg Lynn Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Book opinions... In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Greg Lynn wrote: > > Hello all, has anybody here read these books? > > Unix Internals : The New Frontiers > by: Uresh Vahalia > and > > The Design and Implementation of the 4.4BSD Operating > System (Unix and Open Systems Series.) > by Marshall Kirk McKusick (Editor), Keith Bostic, > Michael J. Karels (Editor) > > If so could you give me some feedback on them? God, many of us have read them. New Frontiers, it's a good overview of how various different modern unixes approach solving problems common to them all. Really recommended AFTER you understand unix to begin with. It's not a basic book, and if you don't understand things like filesystems, shared memory, networking, and interprocess communications (what they are, and how they fit into unix) then this book probably is too much. The second book, The Design and Implementation of the 4.4BSD Operating System, is a really good primer in how 4.4BSD unix works. Consider that it needs somewhat less background to understand (you might want to read this before reading the first book). Honestly, depending on how much one knows of the tasks confronting operating systems, I personally wouldn't recommend either as a first exploration. Please understand that what follows is very much my own opinion, but I think a primer of what the features are is a better place to start. I think that the best place to start is an old AT&T book by Maurice Bach, "The Design Of The Unix Operating System". None of the methods that he describes are really used anymore, but the problems haven't changed, and since he gives *great* little C code snippets that illustrate the problems as clear as day, I think this is the book that ought to be read first. This will set the context for you, and then you will be ready to tackle either of the books above. On top of that, it's an easy, interesting read. > > -Greg > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > ---------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@picnic.mat.net | communications topic, C programming, and Unix. 213 Lakeside Drive Apt T-1 | Greenbelt, MD 20770 | picnic.mat.net: FreeBSD/i386 (301) 220-2114 | jaunt.mat.net : FreeBSD/Alpha ---------------------------+----------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 18:41:26 1999 Delivered-To: freebsd-doc@freebsd.org Received: from vaview5.vavu.vt.edu (vaview5.vavu.vt.edu [198.82.158.16]) by hub.freebsd.org (Postfix) with ESMTP id EB38214C08 for ; Fri, 27 Aug 1999 18:41:21 -0700 (PDT) (envelope-from dglynn@vaview5.vavu.vt.edu) Received: from vaview5.vavu.vt.edu (vaview5.vavu.vt.edu [198.82.158.16]) by vaview5.vavu.vt.edu (8.8.8/8.8.7) with SMTP id VAA09037; Fri, 27 Aug 1999 21:39:27 -0400 (EDT) (envelope-from dglynn@vaview5.vavu.vt.edu) Date: Fri, 27 Aug 1999 21:39:26 -0400 (EDT) From: Greg Lynn To: Chuck Robey Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Book opinions... In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thanks, I guess I should have stated that I do some systems programming in Linux and would atually like to compare the two. I LOVE FreeBSD and wanted to basically know the nitty-griddy like reading through virtual memory structs and algorithms ;-) so would the BSD4.4 book be a good one? -Greg On Fri, 27 Aug 1999, Chuck Robey wrote: > On Fri, 27 Aug 1999, Greg Lynn wrote: > > > > > Hello all, has anybody here read these books? > > > > Unix Internals : The New Frontiers > > by: Uresh Vahalia > > and > > > > The Design and Implementation of the 4.4BSD Operating > > System (Unix and Open Systems Series.) > > by Marshall Kirk McKusick (Editor), Keith Bostic, > > Michael J. Karels (Editor) > > > > If so could you give me some feedback on them? > > God, many of us have read them. New Frontiers, it's a good overview of > how various different modern unixes approach solving problems common to > them all. Really recommended AFTER you understand unix to begin with. > It's not a basic book, and if you don't understand things like > filesystems, shared memory, networking, and interprocess communications > (what they are, and how they fit into unix) then this book probably is > too much. > > The second book, The Design and Implementation of the 4.4BSD Operating > System, is a really good primer in how 4.4BSD unix works. Consider that > it needs somewhat less background to understand (you might want to read > this before reading the first book). > > Honestly, depending on how much one knows of the tasks confronting > operating systems, I personally wouldn't recommend either as a first > exploration. Please understand that what follows is very much my own > opinion, but I think a primer of what the features are is a better place > to start. I think that the best place to start is an old AT&T book by > Maurice Bach, "The Design Of The Unix Operating System". None of the > methods that he describes are really used anymore, but the problems > haven't changed, and since he gives *great* little C code snippets that > illustrate the problems as clear as day, I think this is the book that > ought to be read first. This will set the context for you, and then you > will be ready to tackle either of the books above. On top of that, it's > an easy, interesting read. > > > > > -Greg > > > > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > > with "unsubscribe freebsd-doc" in the body of the message > > > > ---------------------------+----------------------------------------------- > Chuck Robey | Interests include any kind of voice or data > chuckr@picnic.mat.net | communications topic, C programming, and Unix. > 213 Lakeside Drive Apt T-1 | > Greenbelt, MD 20770 | picnic.mat.net: FreeBSD/i386 > (301) 220-2114 | jaunt.mat.net : FreeBSD/Alpha > ---------------------------+----------------------------------------------- > > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Aug 27 20:12:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from picnic.mat.net (picnic.mat.net [206.246.122.133]) by hub.freebsd.org (Postfix) with ESMTP id 6E63C155F7 for ; Fri, 27 Aug 1999 20:09:28 -0700 (PDT) (envelope-from chuckr@picnic.mat.net) Received: from localhost (chuckr@localhost) by picnic.mat.net (8.9.3/8.9.3) with ESMTP id XAA13391; Fri, 27 Aug 1999 23:00:47 -0400 (EDT) (envelope-from chuckr@picnic.mat.net) Date: Fri, 27 Aug 1999 23:00:47 -0400 (EDT) From: Chuck Robey To: Greg Lynn Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Book opinions... In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 27 Aug 1999, Greg Lynn wrote: > Thanks, I guess I should have stated that I do some systems > programming in Linux and would atually like to compare the > two. I LOVE FreeBSD and wanted to basically know the nitty-griddy > like reading through virtual memory structs and algorithms ;-) so would > the BSD4.4 book be a good one? I like both .... yeah, the BSD4.4 book is very good, but FreeBSD has had lots of time to diverge from the book, so while many parts are very good in general, don't be suprised to find that the only real reference to how things work in FreeBSD is our source code. > > -Greg > > > > On Fri, 27 Aug 1999, Chuck Robey wrote: > > > On Fri, 27 Aug 1999, Greg Lynn wrote: > > > > > > > > Hello all, has anybody here read these books? > > > > > > Unix Internals : The New Frontiers > > > by: Uresh Vahalia > > > and > > > > > > The Design and Implementation of the 4.4BSD Operating > > > System (Unix and Open Systems Series.) > > > by Marshall Kirk McKusick (Editor), Keith Bostic, > > > Michael J. Karels (Editor) > > > > > > If so could you give me some feedback on them? > > > > God, many of us have read them. New Frontiers, it's a good overview of > > how various different modern unixes approach solving problems common to > > them all. Really recommended AFTER you understand unix to begin with. > > It's not a basic book, and if you don't understand things like > > filesystems, shared memory, networking, and interprocess communications > > (what they are, and how they fit into unix) then this book probably is > > too much. > > > > > > > The second book, The Design and Implementation of the 4.4BSD Operating > > System, is a really good primer in how 4.4BSD unix works. Consider that > > it needs somewhat less background to understand (you might want to read > > this before reading the first book). > > > > Honestly, depending on how much one knows of the tasks confronting > > operating systems, I personally wouldn't recommend either as a first > > exploration. Please understand that what follows is very much my own > > opinion, but I think a primer of what the features are is a better place > > to start. I think that the best place to start is an old AT&T book by > > Maurice Bach, "The Design Of The Unix Operating System". None of the > > methods that he describes are really used anymore, but the problems > > haven't changed, and since he gives *great* little C code snippets that > > illustrate the problems as clear as day, I think this is the book that > > ought to be read first. This will set the context for you, and then you > > will be ready to tackle either of the books above. On top of that, it's > > an easy, interesting read. > > > > > > > > -Greg > > > > > > > > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > > > with "unsubscribe freebsd-doc" in the body of the message > > > > > > > ---------------------------+----------------------------------------------- > > Chuck Robey | Interests include any kind of voice or data > > chuckr@picnic.mat.net | communications topic, C programming, and Unix. > > 213 Lakeside Drive Apt T-1 | > > Greenbelt, MD 20770 | picnic.mat.net: FreeBSD/i386 > > (301) 220-2114 | jaunt.mat.net : FreeBSD/Alpha > > ---------------------------+----------------------------------------------- > > > > > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > ---------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@picnic.mat.net | communications topic, C programming, and Unix. 213 Lakeside Drive Apt T-1 | Greenbelt, MD 20770 | picnic.mat.net: FreeBSD/i386 (301) 220-2114 | jaunt.mat.net : FreeBSD/Alpha ---------------------------+----------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 0: 4:57 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 8E28D14D01; Sat, 28 Aug 1999 00:04:56 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Received: (from mpp@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA26827; Sat, 28 Aug 1999 00:04:56 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Date: Sat, 28 Aug 1999 00:04:56 -0700 (PDT) From: Message-Id: <199908280704.AAA26827@freefall.freebsd.org> To: mpp@FreeBSD.org, freebsd-doc@FreeBSD.org, mpp@FreeBSD.org Subject: Re: docs/13421: src/lib/libc/sys/*.2 misc patch pack Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: src/lib/libc/sys/*.2 misc patch pack Responsible-Changed-From-To: freebsd-doc->mpp Responsible-Changed-By: mpp Responsible-Changed-When: Sat Aug 28 00:04:01 PDT 1999 Responsible-Changed-Why: I'll field this one. I'm not sure that the propose fix is correct, but I'm discussing this with Alexey & on the mailing lists about this. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 0: 9:14 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 532A114D01; Sat, 28 Aug 1999 00:09:13 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Received: (from mpp@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA27095; Sat, 28 Aug 1999 00:07:47 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Date: Sat, 28 Aug 1999 00:07:47 -0700 (PDT) From: Message-Id: <199908280707.AAA27095@freefall.freebsd.org> To: mpp@FreeBSD.org, freebsd-doc@FreeBSD.org, mpp@FreeBSD.org Subject: Re: docs/13418: Some manpages still not have $Id$ line Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Some manpages still not have $Id$ line Responsible-Changed-From-To: freebsd-doc->mpp Responsible-Changed-By: mpp Responsible-Changed-When: Sat Aug 28 00:05:45 PDT 1999 Responsible-Changed-Why: The recent $Id$ -> $FreeBSD$ commit made this whole patch moot. But some of this will still apply, so I'll work with the principals involved and get everything sorted out. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 0:21:43 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id B3ED015FFE for ; Sat, 28 Aug 1999 00:21:25 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA27752; Sat, 28 Aug 1999 00:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 8A08514D01 for ; Sat, 28 Aug 1999 00:10:22 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id KAA04687 for FreeBSD-gnats-submit@freebsd.org; Sat, 28 Aug 1999 10:11:46 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id JAA01550; Sat, 28 Aug 1999 09:52:12 +0400 (MSD) Message-Id: <199908280552.JAA01550@scorpion.crimea.ua> Date: Sat, 28 Aug 1999 09:52:12 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13436: [PATCH] pkg_install staff manpages mdoc(7)'fy and description fix Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13436 >Category: docs >Synopsis: pkg_install staff mdoc(7)'fy and pkg_info.1 desc fix >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: Sat Aug 28 00:20:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped this night >Description: - mdoc(7)'fy - I already thought that pkg_create(1) only creates packages, but pkg_info.1 said that pkg_create(1) also can install packages. Am I wrong ? >How-To-Repeat: >Fix: Index: add/pkg_add.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/add/pkg_add.1,v retrieving revision 1.31 diff -c -c -r1.31 pkg_add.1 *** pkg_add.1 1999/08/15 08:47:04 1.31 --- pkg_add.1 1999/08/28 05:38:37 *************** *** 36,48 **** with the .Xr pkg_create 1 command. - .Sh WARNING .Bf -emphasis Since the .Nm command may execute scripts or programs contained within a package file, ! your system may be susceptible to ``trojan horses'' or other subtle attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who --- 36,49 ---- with the .Xr pkg_create 1 command. .Sh WARNING .Bf -emphasis Since the .Nm command may execute scripts or programs contained within a package file, ! your system may be susceptible to ! .Dq Em trojan horses ! or other subtle attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who *************** *** 123,129 **** .Ar template as the input to .Xr mktemp 3 ! when creating a ``staging area.'' By default, this is the string .Pa /var/tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where --- 124,131 ---- .Ar template as the input to .Xr mktemp 3 ! when creating a ! .Dq staging area . By default, this is the string .Pa /var/tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where *************** *** 177,183 **** One or more .Ar pkg-name arguments may be specified, each being either a file containing the ! package (these usually ending with the ``.tgz'' suffix) or a URL pointing at a file available on an ftp site. Thus you may extract files directly from their anonymous ftp locations (e.g. .Nm --- 179,187 ---- One or more .Ar pkg-name arguments may be specified, each being either a file containing the ! package (these usually ending with the ! .Dq .tgz ! suffix) or a URL pointing at a file available on an ftp site. Thus you may extract files directly from their anonymous ftp locations (e.g. .Nm *************** *** 338,344 **** .Ar PRE-INSTALL is that this allows you to write a single .Ar install ! script that does both ``before and after'' actions. But, separating the functionality is more advantageous and easier from a maintainence viewpoint. .It After installation is complete, a copy of the packing list, --- 342,350 ---- .Ar PRE-INSTALL is that this allows you to write a single .Ar install ! script that does both ! .Dq before and after ! actions. But, separating the functionality is more advantageous and easier from a maintainence viewpoint. .It After installation is complete, a copy of the packing list, Index: create/pkg_create.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/create/pkg_create.1,v retrieving revision 1.28 diff -c -c -r1.28 pkg_create.1 *** pkg_create.1 1999/08/15 08:47:05 1.28 --- pkg_create.1 1999/08/28 05:33:57 *************** *** 63,69 **** The following command line options are supported: .Bl -tag -width indent .It Fl f Ar packinglist ! Fetch ``packing list'' for package from the file .Ar packinglist or .Cm stdin --- 63,71 ---- The following command line options are supported: .Bl -tag -width indent .It Fl f Ar packinglist ! Fetch ! .Dq packing list ! for package from the file .Ar packinglist or .Cm stdin *************** *** 73,79 **** .Cm - (dash). .It Fl c Ar [-]desc ! Fetch package ``one line description'' from file .Ar desc or, if preceded by .Cm - , --- 75,83 ---- .Cm - (dash). .It Fl c Ar [-]desc ! Fetch package ! .Dq one line description ! from file .Ar desc or, if preceded by .Cm - , *************** *** 136,142 **** .It Fl p Ar prefix Set .Ar prefix ! as the initial directory ``base'' to start from in selecting files for the package. .It Fl k Ar dscript Set --- 140,148 ---- .It Fl p Ar prefix Set .Ar prefix ! as the initial directory ! .Dq base ! to start from in selecting files for the package. .It Fl k Ar dscript Set *************** *** 167,173 **** .It Fl r Ar rscript Set .Ar rscript ! to be the ``requirements'' procedure for the package. This can be any executable program (or shell script). It will be invoked automatically at installation/deinstallation time to determine whether or not installation/deinstallation should proceed. --- 173,181 ---- .It Fl r Ar rscript Set .Ar rscript ! to be the ! .Dq requirements ! procedure for the package. This can be any executable program (or shell script). It will be invoked automatically at installation/deinstallation time to determine whether or not installation/deinstallation should proceed. *************** *** 230,236 **** .El .Pp .Sh PACKING LIST DETAILS ! The ``packing list'' format (see .Fl f ) is fairly simple, being nothing more than a single column of filenames to include in the --- 238,246 ---- .El .Pp .Sh PACKING LIST DETAILS ! The ! .Dq packing list ! format (see .Fl f ) is fairly simple, being nothing more than a single column of filenames to include in the *************** *** 276,287 **** in the example case .Pa /usr/local . .It Cm "%B" ! Expand to the ``basename'' of the fully qualified filename, that is the current directory prefix, plus the last filespec, minus the trailing filename. In the example case, that would be .Pa /usr/local/bin . .It Cm "%f" ! Expand to the ``filename'' part of the fully qualified name, or the converse of .Cm %B , being in the example case, --- 286,301 ---- in the example case .Pa /usr/local . .It Cm "%B" ! Expand to the ! .Dq basename ! of the fully qualified filename, that is the current directory prefix, plus the last filespec, minus the trailing filename. In the example case, that would be .Pa /usr/local/bin . .It Cm "%f" ! Expand to the ! filename ! part of the fully qualified name, or the converse of .Cm %B , being in the example case, *************** *** 302,309 **** the package's table of contents (and hence not automatically removable). The advantage of using .Cm @unexec ! over a deinstallation script is that you can use the ``special ! sequence expansion'' to get at files regardless of where they've been potentially redirected (see .Fl p ) . .It Cm @mode Ar mode --- 316,324 ---- the package's table of contents (and hence not automatically removable). The advantage of using .Cm @unexec ! over a deinstallation script is that you can use the ! .Dq special sequence expansion ! to get at files regardless of where they've been potentially redirected (see .Fl p ) . .It Cm @mode Ar mode Index: delete/pkg_delete.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/delete/pkg_delete.1,v retrieving revision 1.13 diff -c -c -r1.13 pkg_delete.1 *** pkg_delete.1 1999/08/15 08:47:06 1.13 --- pkg_delete.1 1999/08/28 05:41:46 *************** *** 35,47 **** with the .Xr pkg_add 1 command. - .Sh WARNING .Bf -emphasis Since the .Nm command may execute scripts or programs provided by a package file, ! your system may be susceptible to ``trojan horses'' or other subtle attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who --- 35,48 ---- with the .Xr pkg_add 1 command. .Sh WARNING .Bf -emphasis Since the .Nm command may execute scripts or programs provided by a package file, ! your system may be susceptible to ! .Dq Em trojan horses ! or other subtle attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who Index: info/pkg_info.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/info/pkg_info.1,v retrieving revision 1.20 diff -c -c -r1.20 pkg_info.1 *** pkg_info.1 1999/08/15 08:47:07 1.20 --- pkg_info.1 1999/08/28 05:35:46 *************** *** 36,44 **** The .Nm command is used to dump out information for packages, either packed up in ! files or already installed on the system ! with the .Xr pkg_create 1 command. .Sh OPTIONS The following command line options are supported: --- 36,46 ---- The .Nm command is used to dump out information for packages, either packed up in ! files with the .Xr pkg_create 1 + command or already installed on the system + with the + .Xr pkg_add 1 command. .Sh OPTIONS The following command line options are supported: *************** *** 54,60 **** .It Fl p Show the installation prefix for each package. .It Fl q ! Be ``quiet'' in emitting report headers and such, just dump the raw info (basically, assume a non-human reading). .It Fl c Show the comment (one liner) field for each package. --- 56,64 ---- .It Fl p Show the installation prefix for each package. .It Fl q ! Be ! .Dq quiet ! in emitting report headers and such, just dump the raw info (basically, assume a non-human reading). .It Fl c Show the comment (one liner) field for each package. *************** *** 102,108 **** .Ar template as the input to .Xr mktemp 3 ! when creating a ``staging area.'' By default, this is the string .Pa /tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where --- 106,113 ---- .Ar template as the input to .Xr mktemp 3 ! when creating a ! .Dq staging area . By default, this is the string .Pa /tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 0:57:26 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mpp.pro-ns.net (pppdsle70.mpls.uswest.net [216.160.23.70]) by hub.freebsd.org (Postfix) with ESMTP id 0CAEB15233; Sat, 28 Aug 1999 00:57:22 -0700 (PDT) (envelope-from mpp@mpp.pro-ns.net) Received: (from mpp@localhost) by mpp.pro-ns.net (8.9.3/8.9.3) id CAA93164; Sat, 28 Aug 1999 02:29:08 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199908280729.CAA93164@mpp.pro-ns.net> Subject: Propose mdoc fix regarding ERRORS section To: freebsd-hackers@freebsd.org, freebsd-doc@freebsd.org Date: Sat, 28 Aug 1999 02:29:08 -0500 (CDT) Cc: phantom@cris.net X-Mailer: ELM [version 2.4ME+ PL54 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Category: docs >Synopsis: src/lib/libc/sys/*.2 misc patch pack - first column in most ERROR lists is too narrow. Normalize their width. Right now we have a problem with our on-line man pages. Most were written when the length of errno's were only 6 - 8 characters long. Now we have errno's that can be up to 15 characters long. Many of our man pages have the following mdoc instruction (or something similar) to ensure that the field width for the errno is appropriate: .Bl -tag -width EBADFXXX As things have progressed, sometimes the errno names have become wider than the name specified in the .Bl macro. Man pages can also specify: .Bl -tag -width Er Which will reserve enough space for the errno name based on what width the Er macro specifies. Right now it doesn't allocate enough width to contain our largest errno's. I propose that we fix mdoc to allocate enough width when the second form is specified, and then change all of the man pages to use that format in the ERRORS section. Suggestions/comments/etc welcome. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 1:53:11 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id B226B14DBE; Sat, 28 Aug 1999 01:52:04 -0700 (PDT) (envelope-from ph@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id LAA06044; Sat, 28 Aug 1999 11:50:47 +0400 (MSD) (envelope-from ph@scorpion.crimea.ua) Received: (from ph@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id KAA02279; Sat, 28 Aug 1999 10:43:27 +0400 (MSD) Message-Id: <199908280643.KAA02279@scorpion.crimea.ua> Subject: Re: docs/13418: Some manpages still not have $Id$ line In-Reply-To: <199908280707.AAA27095@freefall.freebsd.org> from "mpp@FreeBSD.ORG" at "Aug 28, 99 00:07:47 am" To: mpp@FreeBSD.ORG Date: Sat, 28 Aug 1999 10:43:26 +0400 (MSD) Cc: freebsd-doc@FreeBSD.ORG From: "Alexey M. Zelkin" X-Mailer: ELM [version 2.4ME+ PL40 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, > Synopsis: Some manpages still not have $Id$ line > > Responsible-Changed-From-To: freebsd-doc->mpp > Responsible-Changed-By: mpp > Responsible-Changed-When: Sat Aug 28 00:05:45 PDT 1999 > Responsible-Changed-Why: > The recent $Id$ -> $FreeBSD$ commit made this whole patch moot. > But some of this will still apply, so I'll work with the > principals involved and get everything sorted out. Sure. This patch is almost adding new lines to manpages :) I sure that adopting to $FreeBSD$ case is easy. -- Sincerely Yours, Alexey Zelkin mailto:phantom@sunbay.com, ICQ: #6196584 Sunbay Software, Ltd. http://www.sunbay.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:32:53 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id C718514D7A for ; Sat, 28 Aug 1999 02:32:46 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71875 for ; Sat, 28 Aug 1999 10:27:39 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id QAA37869 for doc@freebsd.org; Fri, 27 Aug 1999 16:41:16 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 16:41:15 +0100 From: Nik Clayton To: doc@freebsd.org Subject: Missing e-mail, PR for review? Message-ID: <19990827164115.A37071@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org -doc, Sorry to do this -- I have a definite recollection that some time in the past 24 hours someone e-mailed me their stab at a DocBook'ification of a currently outstanding PR. I can remember phrases like " didn't work for me, so I used " from the message, but that's about it. Of course, now that I try and find the thing to review it properly, I can't find it in my mail box, so I assume I've been over zealous with the delete key. So, if you're the person that sent this to me, could you resend it please, and I'll gladly take a look at it. Sorry for the inconvenience. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:36:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 97F1914D0F for ; Sat, 28 Aug 1999 02:32:46 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71884 for ; Sat, 28 Aug 1999 10:27:40 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id NAA30132 for doc@freebsd.org; Fri, 27 Aug 1999 13:22:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 13:22:42 +0100 From: Nik Clayton To: doc@freebsd.org Subject: Supporting non-DocBook documents in the tree Message-ID: <19990827132242.A26830@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org -doc, Just an idea I'm kicking around at the moment, and feedback would be useful. Please note that I'm not talking about doing any of this yet, but I'd like to know people's opinions. I think it's probably a bad idea if we insist that documentation that's stored under doc/ be in DocBook format. DocBook's a great format, and it should certainly be the 'official' DTD of the project, but there are certainly going to be some authors who can't use it for some reason. Specifically, I'm thinking of the sort of author who's just made a bit of a breakthrough on something ("How I got my mumblefrozz card working under FreeBSD") and wants to contribute that to the project. They've written it up in either plain text, or HTML, and that's what they send us. Their point of view is that they're doing us a favour, and that they shouldn't have to spend more of their time learning DocBook before we'll take their article. I think this is a wholly understandable point of view. I get the impression that we're currently viewed as being a bit inflexible about the formats that we accept documentation in, and that even when we do accept submissions, it takes us a while to get around to converting them to DocBook. This is mostly due to lack of manpower. So, how would we work around this, given that the current tree is geared up to accept DocBook text[1], and convert that to the appropriate output formats? Each piece of documentation in the tree has to have a Makefile associated with it, right? So there's no reason why we couldn't create a new make(1) variable (SOURCE_FORMAT ?) that describes what the document's source format is, and then the various make(1) rules that do the conversion from $SOURCE_FORMAT to html, plain text, Postscript, and PDF all look at $SOURCE_FORMAT to decide how to do the conversion. For example, if $SOURCE_FORMAT == docbook then things stay pretty much as they are. If $SOURCE_FORMAT == ascii (or perhaps, us-iso-8859-1, or whatever) then we do conversion to HTML by pre/ap-pending "
" and 
"
", conversion to Postscript with txt2ps (or maybe pre/ap-pending some boilerplate TeX, and then running it through TeX), and so on. We still wouldn't accept raw LinuxDoc though, that would be converted to DocBook before being imported in to the tree. The overall effect is that this would get more documentation in to the tree, where it can be seen by more pairs of eyes, more people can practice converting other formats to DocBook, and, through the CVS logs, more people can see how you go about converting something from plain text or HTML to DocBook, helping to demystify the process. We live or die by the quality and quantity of documentation that we make available, and I don't ever want to see us in a position where someone's perfectly good article or book isn't accepted in to the tree because it's in the wrong format, and we don't have the manpower to spare to convert it to DocBook. One obvious consequence of this is the FreeBSD 'house style'. As you can see when you look at the books and articles that are already in the tree, they've adopted a 'house style', because the HTML and other formats that are generated are run through the same stylesheets. Obviously, J. Random submissions from other people that weren't in DocBook wouldn't be in the house style. But I think that's a small price to pay in order to get the documentation in to the tree in the first place, where it's as useful as possible to the maximum number of people. Over time, the documents will migrate to the house style as they are converted to DocBook. I can see the question that's going to be immediately asked: "Why, then, did we just go through all the pain of moving from LinuxDoc to DocBook?" There are a couple of reasons for this. The 'flagship' documentation for FreeBSD should certainly be in our flagship format, specifically, DocBook. DocBook is far more suited to this type of documentation than LinuxDoc is. LinuxDoc can also be mechanically translated to DocBook with the minimum of fuss. This is not the case for other formats, such as plain text, or HTML. N [1] That's not strictly true -- the Japanese subdirectory has contents marked up in *roff. I refer, of course, to the manual pages. -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:36:58 1999 Delivered-To: freebsd-doc@freebsd.org Received: from namaste.cc.columbia.edu (namaste.cc.columbia.edu [128.59.35.141]) by hub.freebsd.org (Postfix) with ESMTP id EB4D9151E7 for ; Sat, 28 Aug 1999 02:36:55 -0700 (PDT) (envelope-from mew20@columbia.edu) Received: from matt-s-ibm (mwong.i002.law.columbia.edu [128.59.136.51]) by namaste.cc.columbia.edu (8.9.3/8.9.3) with SMTP id FAA09715 for ; Sat, 28 Aug 1999 05:35:59 -0400 (EDT) Message-Id: <3.0.6.32.19990828053523.0086bc00@imap.columbia.edu> X-Sender: mew20@imap.columbia.edu X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.6 (32) Date: Sat, 28 Aug 1999 05:35:23 +0800 To: freebsd-doc@FreeBSD.org From: Pluto Relay Subject: read-only?? install problem Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, Since the FreeBSD books with CD's are backed up 3-5 weeks, I tried to install it using floppies (on a Dell PowerEdge 2300, with 2 SCSI HDs on an Adaptec AIC-7890). After installing "bin", I had some problem that it couldn't write to the /etc directory ("the commit operation completed with errors. Not updating /etc files"). Now when I boot up (from the hard disk), it always goes to the installation program, and I can't get a command line prompt. Whenever I try to do something in the install program, I get the error "Couldn't create directory /tmp/doc.: Read-only file system" or something similar. I've tried to find information on this subject but have come up with nothing. Do you have any suggestions? Thanks -Matt To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:37:20 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id D31AD154DB for ; Sat, 28 Aug 1999 02:32:46 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71886; Sat, 28 Aug 1999 10:27:41 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id MAA21795; Fri, 27 Aug 1999 12:14:39 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 12:14:39 +0100 From: Nik Clayton To: Makoto MATSUSHITA Cc: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken Message-ID: <19990827121439.D15526@kilt.nothing-going-on.org> References: <19990826192109K.matusita@matatabi.or.jp> <19990826211830.C86126@catkin.nothing-going-on.org> <19990827103938O.matusita@matatabi.or.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990827103938O.matusita@matatabi.or.jp>; from Makoto MATSUSHITA on Fri, Aug 27, 1999 at 10:39:38AM +0900 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Aug 27, 1999 at 10:39:38AM +0900, Makoto MATSUSHITA wrote: > > nik> Thanks for the pointer. I think this is now fixed, but I'd appreciate > nik> confirmation. > > There are still some strange characters in documents, but most of them > are fine to read, very thank you. Can you be more specific about the ones that aren't correct? > nik> As I say, the Handbook will also have been broken, and for the > nik> same reason. However, if there are any other pages that have the > nik> same problem could you please let me know about them? > > Ahhh, I want to say in previous mail that other FAQ documents (not > only the entry page of FAQ) are also broken. OK, that's to be expected, as they were built using the same mechanism. However, currently, the Japanese FAQ and Handbook should be fine. If this is not the case, please let me know about it. I can't speak for the rest of www.FreeBSD.org/ja/, as that's the domain of the Japanese translation team. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:44: 0 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 66F3C15C26; Sat, 28 Aug 1999 02:43:24 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71896; Sat, 28 Aug 1999 10:27:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id MAA21529; Fri, 27 Aug 1999 12:12:32 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 12:12:32 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: nik@freebsd.org, doc@freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <19990827121232.C15526@kilt.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <19990819131224.A844@kilt.nothing-going-on.org> <19990825001406.A62322@catkin.nothing-going-on.org> <199908270024.RAA27527@silvia.hip.berkeley.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908270024.RAA27527@silvia.hip.berkeley.edu>; from Satoshi - Ports Wraith - Asami on Thu, Aug 26, 1999 at 05:24:48PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 05:24:48PM -0700, Satoshi - Ports Wraith - Asami wrote: > * From: Nik Clayton > > * Please can you look at > * > * > * > * and let me know if that's the sort of format you want to see. If you > * need any tweaks we should be able to accomodate them. > > Yes, that looks much better. If you ask me, I'd prefer sections with > more than one version number component to not have the period at the > end (e.g., 4.6 instead of 4.6.) but I can live with what you have > now. That's feasible too, although it's more work. If you take a look in /usr/local/share/sgml/docbook/dsssl/modular/common/, and the file dbl1en.dsl, you'll see there's a collection of lines that look like ... (define en-refsect2-label-title-sep ". ") (define en-refsect3-label-title-sep ". ") (define en-sect1-label-title-sep ". ") (define en-sect2-label-title-sep ". ") (define en-sect3-label-title-sep ". ") ... In this case, en-sect1-label-title-sep is the string that will appear between the section label (i.e., '1.1') and the title of the section. Currently, with that set to '. ' you get things like 1.4. The FreeBSD Development Model ^^ in the output. The bit I've underlined is where en-sect1-label-title-sep is being used. So, if you were to go and edit doc/share/sgml/freebsd.dsl, and add a line like (define en-sect1-label-title-sep " ") then the output would be 1.4 The FreeBSD Development Model which is what you've asked for. See the power and flexibility of DocBook, coupled with Norm Walsh's stylesheets. You couldn't do this with our old system. But (there's always a 'but') if you look at the dbl1en.dsl file that I mentioned earlier, you'll see that there are about 30 of these -sep variables that need to be configured, and that they are duplicated (with different prefixes) for all the other languages we support as well (ja-, es-, and so on). Being candid, I haven't really got the time, or the inclination, to go through and override the definition of these in our freebsd.dsl, and to do it for all the other languages as well. But, if anyone reading this feels badly enough about this to actually do the work, I'll cheerfully accept patches > Also, glancing around the handbook, I noticed that the "home" and "up" > links are only at the bottom of each page. Can you add them to the > top as well? The technical answer to this is "yes, it's just a SMOP". The practical answer is "I don't know DSSSL well enough to be able to implement it." The code that does all this is in .../modular/html/dbnavig.dsl. It's on my list of things to get my head around, as one of the things that's missing from the stylesheets is an easy way to insert your own arbitrary HTML at the top of the page (this is why the FAQ and the Handbook do not currently have the "yellow FreeBSD link nav bar" at the top of the page the way the rest of the FreeBSD site does. If anyone's reading this, is looking to learn more about DSSSL, and wants a project to start on, this would be ideal. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:44: 1 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id BF50215C92; Sat, 28 Aug 1999 02:43:24 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71897; Sat, 28 Aug 1999 10:27:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id KAA16221; Fri, 27 Aug 1999 10:50:43 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 10:50:43 +0100 From: Nik Clayton To: "Matthew D. Fuller" Cc: Nik Clayton , Tim Vanderhoek , Motoyuki Konno , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990827105043.A15526@kilt.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990826141141.F24968@futuresouth.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990826141141.F24968@futuresouth.com>; from Matthew D. Fuller on Thu, Aug 26, 1999 at 02:11:42PM -0500 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 26, 1999 at 02:11:42PM -0500, Matthew D. Fuller wrote: > On Thu, Aug 26, 1999 at 11:14:47AM +0100, a little birdie told me > that Nik Clayton remarked > > > > For all the hype about open standards, getting a program to work on > > different versions of Unix in the real world can be a tedious and tricky > I'm in favor of putting markup tags on their own line. Thus: > > For all the hype about open standards, getting a program to work on > different versions of Unix in the real world can be a tedious and > tricky business, as anyone who has tried it will know > ... > With most programs, you will find yourself doing a fair bit of > head-scratching, and there are quite a few programs that will result > in premature greying, or even chronic alopecia... > > > But that may just be a personal quirk. We probably shouldn't, as within some elements the whitespace is significant ( and come to mind). Note that the advice currently given in the primer is wrong about this, and I'll be fixing it tonight. This means you should be writing things like #!/usr/bin/perl print "hello, world\n"; (assume that column 0 in the docs is column 4 above) instead of #!/usr/bin/perl print "hello, world\n"; N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 2:44:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 7DB7415E0A; Sat, 28 Aug 1999 02:44:01 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id KAA71898; Sat, 28 Aug 1999 10:27:42 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id LAA18231; Fri, 27 Aug 1999 11:07:16 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 27 Aug 1999 11:07:16 +0100 From: Nik Clayton To: Satoshi - Ports Wraith - Asami Cc: "Jordan K. Hubbard" , Nik Clayton , jack , current@freebsd.org, doc@freebsd.org Subject: Re: Docs blows up make release Message-ID: <19990827110716.B15526@kilt.nothing-going-on.org> References: <16783.935616425@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from Satoshi - Ports Wraith - Asami on Thu, Aug 26, 1999 at 06:46:38PM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Jordan, Satoshi, Just a reminder: I have *no* objection to the ports tree being used to build packages of the documentation, as long as the maintenance of those ports is assigned to individuals, and not the FDP (and, more specifically, me). However, I think that another mechanism, one that's wholly within doc/, will be useful, for the reasons I've already outlined. On Thu, Aug 26, 1999 at 06:46:38PM -0700, Satoshi - Ports Wraith - Asami wrote: > Another advantage of having them in the ports tree is the build > checking done at regular intervals. OK. But since the doc/ packages will also be being built daily (first on freefall, and then, when I get the time, on the docs.freebsd.org machine (usw1?) that jkh has been talking about, the same comment applies. > All the japanese/handbook stuff > that's going on right now, these are the problems of the > textproc/docbook* ports (missing files from PLIST, missing > dependencies). People installing these from packages will see the > exact same problem when they try to build the handbook (with or > without the japanese/handbook port). Hang on a second. Are we talking about different things here? I want the formatted documentation available as packages so that those people that want formatted docs, but who have neither the time, the inclination, or the machine horsepower to download the textproc/docproj port have a very easy way of installing and managing formatted documentation -- specifically, pkg_add(1). If people want to go and build the documentation from scratch themselves, they should do so by downloading the doc/ repository, and running make(1) in there, not by going through the ports system. That just adds an additional layer of complexity. [ Obviously, people will have to go through the ports system to download the applications they are using to build the docs, or go through the hassle of configuring and installing them themselves ] > * > Putting the package building rules in the doc/ Makefiles also (and this > * > is just my personal opinion) makes it easier for people to see how the > * > documentation packages are built. The ports Makefile structure is a > * > marvel, but it contains a lot of code that's not necessary for building > * > documentation packages (the "automagically add man pages to the PLIST > * > i" code, for example) that makes it more difficult for the interested > * > learner to browse and understand what's going on. > * > * Now this is a point which is more germin. So, you figure on making a > * similar sort of "package" target under doc? I guess it really doesn't > * matter where these things live, as long as it's still automated.. > > The chief concern I have is that this might result in yet another > place you (Jordan) have to pick up stuff from before the release. This shouldn't matter, should it? As long as the automated doc package building puts the files somewhere sensible (in distfiles/ on wcarchive?) it'll get picked up. Remember that the long term plan is to migrate the docs out of the release as a separate distribution, and in to their own packages, so that at sysinstall time the user can pick and choose which docs to install at the level of the individual packages (presumably, with some additional 'meta' choices, that let them say things like "All the English docs, in HTML and PDF, and the Spanish docs in HTML"). Since this (the package building, and sysinstall changes) are not going to be ready for 3.3-RELEASE, I think we should concentrate on ensuring that "make release" works with the new doc/ structure, and that sysinstall knows about the correct locations of the FAQ and Handbook in the new structure. In the meantime, I can continue adding and tweaking (with input from anybody else that's interested) the package building rules under doc/, and then set up a system that automatic builds formatted versions of the latest documentation daily (or weekly, depending on how rapidly the documentation is changing, and how badly people want it). We can then run with this for a bit, see how it works out, and that gives us plenty of time to consider removing the doc distribution (in favour of the packages) in time for 4.0-RELEASE. The ports tree can continue having a japanese/handbook entry for as long as they want. As long as I don't have to support it, I don't care :-) N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 3:30: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 4EA2114DAA for ; Sat, 28 Aug 1999 03:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA37243; Sat, 28 Aug 1999 03:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from mail.cs.tu-berlin.de (mail.cs.tu-berlin.de [130.149.17.13]) by hub.freebsd.org (Postfix) with ESMTP id 3680F15586 for ; Sat, 28 Aug 1999 03:22:52 -0700 (PDT) (envelope-from eserte@cs.tu-berlin.de) Received: (from eserte@localhost) by mail.cs.tu-berlin.de (8.9.1/8.9.1) id MAA07349; Sat, 28 Aug 1999 12:21:43 +0200 (MET DST) Received: (from eserte@localhost) by cabulja.herceg.de (8.8.8/8.6.12) id MAA01724; Sat, 28 Aug 1999 12:21:56 +0200 (CEST) Message-Id: <199908281021.MAA01724@cabulja.herceg.de> Date: Sat, 28 Aug 1999 12:21:56 +0200 (CEST) From: Slaven Rezic Reply-To: eserte@cs.tu-berlin.de To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13439: Update docproj.docbook.mk for palm doc format Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13439 >Category: docs >Synopsis: Update docproj.docbook.mk for palm doc format >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sat Aug 28 03:30:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Slaven Rezic >Release: FreeBSD 2.2.8-RELEASE i386 >Organization: Private FreeBSD site, Berlin, Germany >Environment: >Description: Here's a patch to doc/share/mk/docproj.docbook.mk to use the pilot_makedoc program (this ones is in the ports) to create files in the palm doc format. >How-To-Repeat: >Fix: --- /usr/cvsup/doc/share/mk/docproj.docbook.mk Sat Aug 28 12:12:56 1999 +++ docproj.docbook.mk Sat Aug 28 12:17:44 1999 @@ -88,7 +88,8 @@ JADEOPTS= ${JADEFLAGS} -c ${FREEBSDCATALOG} -c ${DSSSLCATALOG} -c ${DOCBOOKCATALOG} -c ${JADECATALOG} ${EXTRA_CATALOGS:S/^/-c /g} -KNOWN_FORMATS= html html-split html-split.tar txt rtf ps pdf tex dvi tar +KNOWN_FORMATS= html html-split html-split.tar \ + txt rtf ps pdf tex dvi tar pdb # ------------------------------------------------------------------------ # If DOC_PREFIX is not set then try and generate a sensible value for it. @@ -185,6 +186,9 @@ .elif ${_cf} == "doc" _docs+= ${DOC}.doc CLEANFILES+= ${DOC}.doc +.elif ${_cf} == "pdb" +_docs+= ${DOC}.pdb +CLEANFILES+= ${DOC}.pdb .endif .endfor .endif @@ -266,6 +270,9 @@ ${DOC}.tar: tar cf ${.TARGET} ${SRCS} + +${DOC}.pdb: ${DOC}.txt + pilot_makedoc ${DOC}.txt ${DOC}.pdb ${DOC} # ------------------------------------------------------------------------ # >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 3:39:37 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mta1-rme.xtra.co.nz (mta1-rme.xtra.co.nz [203.96.92.1]) by hub.freebsd.org (Postfix) with ESMTP id 3C45C14DAA; Sat, 28 Aug 1999 03:39:32 -0700 (PDT) (envelope-from junkmale@xtra.co.nz) Received: from wocker ([210.55.152.212]) by mta1-rme.xtra.co.nz (InterMail v4.01.01.00 201-229-111) with ESMTP id <19990828104217.PUYK3442178.mta1-rme@wocker>; Sat, 28 Aug 1999 22:42:17 +1200 From: "Dan Langille" Organization: The FreeBSD Diary To: Nik Clayton Date: Sat, 28 Aug 1999 22:37:40 +1200 MIME-Version: 1.0 Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT Subject: Re: Supporting non-DocBook documents in the tree Reply-To: junkmale@xtra.co.nz Cc: doc@freebsd.org In-reply-to: <19990827132242.A26830@kilt.nothing-going-on.org> X-mailer: Pegasus Mail for Win32 (v3.12a) Message-Id: <19990828104217.PUYK3442178.mta1-rme@wocker> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 27 Aug 99, at 13:22, Nik Clayton wrote: > Specifically, I'm thinking of the sort of author who's just made a bit of a > breakthrough on something ("How I got my mumblefrozz card working under > FreeBSD") and wants to contribute that to the project. They've written it > up in either plain text, or HTML, and that's what they send us. Their > point of view is that they're doing us a favour, and that they shouldn't > have to spend more of their time learning DocBook before we'll take their > article. I think this is a wholly understandable point of view. I think it's a good idea to accept non DocBook stuff. > I get the impression that we're currently viewed as being a bit > inflexible about the formats that we accept documentation in, and that even > when we do accept submissions, it takes us a while to get around to > converting them to DocBook. This is mostly due to lack of manpower. What is the main reason for using DocBook as opposed to some other format? -- Dan Langille - DVL Software Limited The FreeBSD Diary - http://www.FreeBSDDiary.org/freebsd/ NZ FreeBSD User Group - http://www.nzfug.nz.freebsd.org/ The Racing System - http://www.racingsystem.com/racingsystem.htm To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 7: 7:37 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 3234C14DE8; Sat, 28 Aug 1999 07:07:16 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA06299; Sat, 28 Aug 1999 14:51:29 +0100 (BST) (envelope-from nik) Date: Sat, 28 Aug 1999 14:51:29 +0100 From: Nik Clayton To: Nik Clayton Cc: "Matthew D. Fuller" , Tim Vanderhoek , Motoyuki Konno , freebsd-doc@FreeBSD.ORG Subject: Re: DocBook formatting style? Message-ID: <19990828145129.A5750@catkin.nothing-going-on.org> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990826141141.F24968@futuresouth.com> <19990827105043.A15526@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990827105043.A15526@kilt.nothing-going-on.org>; from Nik Clayton on Fri, Aug 27, 1999 at 10:50:43AM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org To reply to myself; On Fri, Aug 27, 1999 at 10:50:43AM +0100, Nik Clayton wrote: > On Thu, Aug 26, 1999 at 02:11:42PM -0500, Matthew D. Fuller wrote: > > I'm in favor of putting markup tags on their own line. Thus: > > > > For all the hype about open standards, getting a program to work on > > different versions of Unix in the real world can be a tedious and > > tricky business, as anyone who has tried it will know > > ... > > With most programs, you will find yourself doing a fair bit of > > head-scratching, and there are quite a few programs that will result > > in premature greying, or even chronic alopecia... > > > > > > But that may just be a personal quirk. > > We probably shouldn't, as within some elements the whitespace is > significant ( and come to mind). Note that the > advice currently given in the primer is wrong about this, and I'll be > fixing it tonight. With an eye to the future, I just spotted this quote from Norm Walsh on the Davenport mailing list;
I don't know of one, but on the topic of indentation, I have to say, "be aware of whitespace". My own style has always been to write things like this. But in mixed-content elements (any element that can contain character data is "mixed-content" as opposed to "element-content" where only elements are allowed), that carriage return may be significant. SGML has some interesting rules about this, but XML does not. In XML, that space is significant. If your processor doesn't do the right thing with leading and embedded whitespace, you might not get happy results. I'm now trying to train myself to type like this.
I'm about to reply to Norm about this, and mention the "\n" problem above. And, with an eye to the future, while we're not using XML now, I wouldn't be surprised if it played a much more significant role in our documentation tool set in 12-18 months time. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 7:38:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp11.bellglobal.com (smtp11.bellglobal.com [204.101.251.53]) by hub.freebsd.org (Postfix) with ESMTP id EC59314E04; Sat, 28 Aug 1999 07:38:16 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18415.on.bellglobal.com (ppp18345.on.bellglobal.com [206.172.130.25]) by smtp11.bellglobal.com (8.8.5/8.8.5) with ESMTP id KAA25835; Sat, 28 Aug 1999 10:41:02 -0400 (EDT) Received: (from tim@localhost) by ppp18415.on.bellglobal.com (8.9.3/8.9.1) id KAA50177; Sat, 28 Aug 1999 10:37:36 -0400 (EDT) (envelope-from tim) Date: Sat, 28 Aug 1999 10:37:36 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990828103736.C49983@ppp18415.on.bellglobal.com> Reply-To: hoek@freebsd.org References: <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org> <19990826141141.F24968@futuresouth.com> <19990827105043.A15526@kilt.nothing-going-on.org> <19990828145129.A5750@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990828145129.A5750@catkin.nothing-going-on.org>; from Nik Clayton on Sat, Aug 28, 1999 at 02:51:29PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sat, Aug 28, 1999 at 02:51:29PM +0100, Nik Clayton wrote: > > problem above. And, with an eye to the future, while we're not using XML > now, I wouldn't be surprised if it played a much more significant role in > our documentation tool set in 12-18 months time. What are the advantages of XML? I remember jfieber had a rather negative opinion about it... (But that was a long time ago when it was first announced). [Short summary form, eg. "Better support by applications", is acceptable... :-] -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 9: 5:50 1999 Delivered-To: freebsd-doc@freebsd.org Received: from martini.ics.es.osaka-u.ac.jp (martini.ics.es.osaka-u.ac.jp [133.1.12.150]) by hub.freebsd.org (Postfix) with ESMTP id DEADD14D62 for ; Sat, 28 Aug 1999 09:05:39 -0700 (PDT) (envelope-from matusita@matatabi.or.jp) Received: from localhost (localhost [127.0.0.1]) by martini.ics.es.osaka-u.ac.jp (8.9.3/3.7W/INO-1.0v8-SLAVE) with ESMTP id BAA03293 for ; Sun, 29 Aug 1999 01:05:34 +0900 (JST) In-Reply-To: <19990827121439.D15526@kilt.nothing-going-on.org> References: <19990826211830.C86126@catkin.nothing-going-on.org> <19990827103938O.matusita@matatabi.or.jp> <19990827121439.D15526@kilt.nothing-going-on.org> X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94b51 XEmacs/21.2 (Toshima) X-SKK-Version: 10.49 X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) X-Fingerprint: 0C AC 93 FC E3 9D 9E 5B 3D B8 AC 5C 4A 79 D8 A6 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 990818(IM122) Lines: 11 From: Makoto MATSUSHITA (=?ISO-2022-JP?B?GyRCJF4kRCQ3JD8kXiQzJEgbKEI=?=) To: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken Date: Sun, 29 Aug 1999 01:05:31 +0900 Message-Id: <19990829010531E.matusita@matatabi.or.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org nik> Can you be more specific about the ones that aren't correct? Just a example: In Item 7 (What is the FreeBSD-stable concept?), ascii figure of the FreeBSD history is broken (Maybe indent characters are changed to unexpected characters). -- - Makoto `MAR' MATSUSHITA To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 9:16:16 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp02.wxs.nl (smtp02.wxs.nl [195.121.6.60]) by hub.freebsd.org (Postfix) with ESMTP id 81E4714F41; Sat, 28 Aug 1999 09:16:04 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.196.75]) by smtp02.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAA43CD; Sat, 28 Aug 1999 18:14:23 +0200 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id SAA46240; Sat, 28 Aug 1999 18:08:18 +0200 (CEST) (envelope-from asmodai) Date: Sat, 28 Aug 1999 18:08:18 +0200 From: Jeroen Ruigrok/Asmodai To: Dan Langille Cc: Nik Clayton , doc@freebsd.org Subject: Re: Supporting non-DocBook documents in the tree Message-ID: <19990828180818.A46221@daemon.ninth-circle.org> References: <19990827132242.A26830@kilt.nothing-going-on.org> <19990828104217.PUYK3442178.mta1-rme@wocker> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <19990828104217.PUYK3442178.mta1-rme@wocker> Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * Dan Langille (junkmale@xtra.co.nz) [990828 14:44]: >What is the main reason for using DocBook as opposed to some other format? DocBook, as opposed to HTML and such, is a markup language in the form that describes a document and how it's built up rather than formatting marking up. DocBook is a very good `language' to write books in since it has a well supported and responsive community. Anyone with the appropriate stylesheets and programs [sgml stuff] can easily use docbook to export their docbook SGML stuff to PDF, PS, etc. I think I missed a few things here which Nik can answer/supply, but those were the main reasons for me to use docbook after reading some on it in the DocProj. cheers Dan =) -- Jeroen Ruigrok van der Werven asmodai(at)wxs.nl The BSD Programmer's Documentation Project Network/Security Specialist BSD: Technical excellence at its best There are only 2 families in the world, the Haves, and the Have Nots. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 9:16:17 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp02.wxs.nl (smtp02.wxs.nl [195.121.6.60]) by hub.freebsd.org (Postfix) with ESMTP id 9A2291530C; Sat, 28 Aug 1999 09:16:04 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.196.75]) by smtp02.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAB43CD; Sat, 28 Aug 1999 18:14:24 +0200 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id SAA46249; Sat, 28 Aug 1999 18:13:10 +0200 (CEST) (envelope-from asmodai) Date: Sat, 28 Aug 1999 18:13:10 +0200 From: Jeroen Ruigrok/Asmodai To: Mike Pritchard Cc: freebsd-hackers@freebsd.org, freebsd-doc@freebsd.org, phantom@cris.net Subject: Re: Propose mdoc fix regarding ERRORS section Message-ID: <19990828181310.B46221@daemon.ninth-circle.org> References: <199908280729.CAA93164@mpp.pro-ns.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <199908280729.CAA93164@mpp.pro-ns.net> Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * Mike Pritchard (mpp@mpp.pro-ns.net) [990828 11:44]: >>Category: docs >>Synopsis: src/lib/libc/sys/*.2 misc patch pack >- first column in most ERROR lists is too narrow. Normalize their width. > >Right now we have a problem with our on-line man pages. Most were >written when the length of errno's were only 6 - 8 characters long. >Now we have errno's that can be up to 15 characters long. Many >of our man pages have the following mdoc instruction (or something >similar) to ensure that the field width for the errno is appropriate: > >.Bl -tag -width EBADFXXX Most lists do actually. But you already know =) >.Bl -tag -width Er > >Which will reserve enough space for the errno name based on what >width the Er macro specifies. Right now it doesn't allocate enough >width to contain our largest errno's. > >I propose that we fix mdoc to allocate enough width when the second >form is specified, and then change all of the man pages to use that >format in the ERRORS section. I think using -width Er and setting the Er constant to a higher value might be the best thing. Offcourse we need to check all of the manpages in order whether they use -width EBLAHBLAH or -width Er. If you need help, please yell. -- Jeroen Ruigrok van der Werven asmodai(at)wxs.nl The BSD Programmer's Documentation Project Network/Security Specialist BSD: Technical excellence at its best Fame is the perfume of heroic deeds. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 10:30:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 4BFDC1561B for ; Sat, 28 Aug 1999 10:30:49 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA29694; Sat, 28 Aug 1999 10:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id 9EC7A15058; Sat, 28 Aug 1999 10:29:55 -0700 (PDT) Message-Id: <19990828172955.9EC7A15058@hub.freebsd.org> Date: Sat, 28 Aug 1999 10:29:55 -0700 (PDT) From: efrias@sg505.net To: freebsd-gnats-submit@freebsd.org Subject: docs/13441: incorrect path in SGML_CATALOG_FILES env variable Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13441 >Category: docs >Synopsis: incorrect path in SGML_CATALOG_FILES env variable >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: Sat Aug 28 10:30:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Eric Frias >Release: 3.2-RELEASE >Organization: >Environment: Standard 3.2-RELEASE with up-to-date ports collection >Description: In the FreeBSD Documentation Project Primer, example 3-6 and 3-7 suggest setting SGML_CATALOG_FILES to ${SGML_ROOT}/docbook/catalog:$SGML_CATALOG_FILES which was incorrect on my system. >How-To-Repeat: >Fix: $SGML_ROOT/docbook on my system contains subdirectories for each version: 2.4.1, 3.0, 3.1, and dsssl. SGML_CATALOG_FILES should be pointed at ${SGML_ROOT}/docbook/3.1/catalog, or perhaps add a line for each versions. >Release-Note: >Audit-Trail: >Unformatted: X-Send-Pr-Version: www-1.0 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 10:42:12 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 20AF315696 for ; Sat, 28 Aug 1999 10:42:09 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA30000; Sat, 28 Aug 1999 10:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id 695A115601; Sat, 28 Aug 1999 10:31:36 -0700 (PDT) Message-Id: <19990828173136.695A115601@hub.freebsd.org> Date: Sat, 28 Aug 1999 10:31:36 -0700 (PDT) From: efrias@sg505.net To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/13442: docproj-primer does not mention where to get docbook extensions Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13442 >Category: docs >Synopsis: docproj-primer does not mention where to get docbook extensions >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: Sat Aug 28 10:40:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Eric Frias >Release: 3.2-RELEASE >Organization: >Environment: Standard 3.2-release with up-to-date ports collection >Description: Chapter 4 of Docproj-primer mentions using the FreeBSD extensions to DocBook, "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN", but never mentions where to find these. The extensions were not installed as part of the textproj/docproj port, and it was not obvious where to find them. >How-To-Repeat: >Fix: * Include a section on where to find the extended DTD and how to install it, or * add a port for it, and add it to the docproj meta-port, or * make it obvious that this DTD is not to be used, and suggest an alternate DTD >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 11:29:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 4DDD614CFC; Sat, 28 Aug 1999 11:29:03 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id VAA14822; Sat, 28 Aug 1999 21:29:54 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id VAA06947; Sat, 28 Aug 1999 21:21:31 +0400 (MSD) Date: Sat, 28 Aug 1999 21:21:30 +0400 From: Alexey Zelkin To: Mike Pritchard Cc: freebsd-doc@FreeBSD.org Subject: Re: Propose mdoc fix regarding ERRORS section Message-ID: <19990828212130.A6853@scorpion.crimea.ua> References: <199908280729.CAA93164@mpp.pro-ns.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <199908280729.CAA93164@mpp.pro-ns.net> X-Operating-System: FreeBSD 2.2.7-RELEASE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [-hackers removed from Cc list] hi, On Sat, Aug 28, 1999 at 02:29:08AM -0500, Mike Pritchard wrote: > >Category: docs > >Synopsis: src/lib/libc/sys/*.2 misc patch pack > - first column in most ERROR lists is too narrow. Normalize their width. > Man pages can also specify: > > .Bl -tag -width Er > > Which will reserve enough space for the errno name based on what > width the Er macro specifies. Right now it doesn't allocate enough > width to contain our largest errno's. > > I propose that we fix mdoc to allocate enough width when the second > form is specified, and then change all of the man pages to use that > format in the ERRORS section. I think second way is better. I am going to remake my patch. As first step I did this patch. I used 15 because error name EADDRNOTAVAIL is longest error name I've found. (yes, I know that length is 13, but we also need some space between columns) Index: doc-common =================================================================== RCS file: /usr/local/CVSROOT/src/contrib/groff/tmac/doc-common,v retrieving revision 1.15 diff -u -r1.15 doc-common --- doc-common 1999/05/14 17:35:17 1.15 +++ doc-common 1999/08/28 19:20:31 @@ -68,7 +68,7 @@ .nr Eo 12n .nr Eq 12n .nr Em 10n -.nr Er 12n +.nr Er 15n .nr Ev 15n .nr Ex 10n .nr Fa 12n -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 14:37:19 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mpp.pro-ns.net (pppdsle70.mpls.uswest.net [216.160.23.70]) by hub.freebsd.org (Postfix) with ESMTP id 1BD5D1509B for ; Sat, 28 Aug 1999 14:37:10 -0700 (PDT) (envelope-from mpp@mpp.pro-ns.net) Received: (from mpp@localhost) by mpp.pro-ns.net (8.9.3/8.9.3) id QAA00714; Sat, 28 Aug 1999 16:35:15 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199908282135.QAA00714@mpp.pro-ns.net> Subject: Re: Propose mdoc fix regarding ERRORS section In-Reply-To: <19990828212130.A6853@scorpion.crimea.ua> from Alexey Zelkin at "Aug 28, 1999 09:21:30 pm" To: phantom@cris.net (Alexey Zelkin) Date: Sat, 28 Aug 1999 16:35:15 -0500 (CDT) Cc: freebsd-doc@freebsd.org X-Mailer: ELM [version 2.4ME+ PL54 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > On Sat, Aug 28, 1999 at 02:29:08AM -0500, Mike Pritchard wrote: > > > > I propose that we fix mdoc to allocate enough width when the second > > form is specified, and then change all of the man pages to use that > > format in the ERRORS section. > I think second way is better. I am going to remake my patch. > As first step I did this patch. I used 15 because error name EADDRNOTAVAIL > is longest error name I've found. (yes, I know that length is > 13, but we also need some space between columns) The longest errno's are 15 characters in lenght (EPROTONOSUPPORT), so Er should use width 17. I'll format some man pages using this and see how they look. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 22:14:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mail.kt.rim.or.jp (mail.kt.rim.or.jp [202.247.130.53]) by hub.freebsd.org (Postfix) with ESMTP id 26C1214D2D for ; Sat, 28 Aug 1999 22:14:18 -0700 (PDT) (envelope-from kuriyama@sky.rim.or.jp) Received: from rhea.sky.rim.or.jp (ppp522.kt.rim.or.jp [202.247.140.172]) by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id OAA15095; Sun, 29 Aug 1999 14:12:30 +0900 (JST) Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1]) by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id OAA19854; Sun, 29 Aug 1999 14:12:29 +0900 (JST) Date: Sun, 29 Aug 1999 14:11:55 +0900 Message-ID: <14280.49435.897747.165T@localhost.sky.rim.or.jp> From: Jun Kuriyama To: iwasaki@jp.FreeBSD.org Cc: doc@freebsd.org Subject: doc/ will not freeze In-Reply-To: In your message of "Fri, 27 Aug 1999 02:48:10 +0900" <199908261744.CAA15930@tasogare.imasy.or.jp> References: <37C577381F4.4889ORESAMACHAN@cosmo.jah.ne.jp> <199908261744.CAA15930@tasogare.imasy.or.jp> User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org From: Mitsuru IWASAKI > BTW, when is the doc code freeze for 3.3-RELEASE? What can we do > before that? Usually, doc tree will not freeze around release because it has no branch such as RELENG_*. Jun Kuriyama // kuriyama@sky.rim.or.jp // kuriyama@FreeBSD.ORG To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 22:14:28 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mail.kt.rim.or.jp (mail.kt.rim.or.jp [202.247.130.53]) by hub.freebsd.org (Postfix) with ESMTP id C30D114F1B for ; Sat, 28 Aug 1999 22:14:22 -0700 (PDT) (envelope-from kuriyama@sky.rim.or.jp) Received: from rhea.sky.rim.or.jp (ppp522.kt.rim.or.jp [202.247.140.172]) by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id OAA15111 for ; Sun, 29 Aug 1999 14:12:37 +0900 (JST) Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1]) by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id OAA19867 for ; Sun, 29 Aug 1999 14:12:35 +0900 (JST) Date: Sun, 29 Aug 1999 14:12:09 +0900 Message-ID: <14280.49449.39009.25288P@localhost.sky.rim.or.jp> From: Jun Kuriyama To: doc@freebsd.org Subject: Re: Japanese FAQ on the Web is broken In-Reply-To: In your message of "Thu, 26 Aug 1999 21:18:30 +0100" <19990826211830.C86126@catkin.nothing-going-on.org> References: <19990826192109K.matusita@matatabi.or.jp> <19990826211830.C86126@catkin.nothing-going-on.org> User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org From: Nik Clayton > The "normal" way to tell the stylesheets what language your document is > written in is to add the 'lang="xx"' attribute to the first element in > your document. For example, the Japanese Handbook (or FAQ) should start > > If you look at the Spanish FAQ you'll see it starts > > For reasons I don't fully understand (Jun Kuriyama is the expert here) > this isn't working properly for the Japanese translation. I believe Jun > has patches for this problem for the stylesheets, but they have not yet > been incorporated in to the version we use (I think that's the case, but > Jun might well correct me on this point). Some days ago, Norm's dsssl-docbook-modular begins to contain Japanese i18n modules. It is encoded in Unicode with UTF-8 but my old patches and Japanese Documentation Project are using EUC-JP encoding. I've discussed about it with original author of Norm's Japanese modules, and we decide it is good way to include UTF-8, EUC-JP and Shift_JIS encoding in Norm's distribution in current situation of Japanese encoding scheme problem. But (of course, it's my fault) this work has not be done. So Japanese Handbook will not use 'lang="ja"' until this feature is implemented. > This is a rather convoluted way of saying > If the tools that process the Japanese documentation have the command > line flag '-ilang.ja' passed to them, add the additional HTML header > tags "Content-Type", and set it to "text/html; charset=EUC-JP". > This is what your web browser is looking for before it will switch to using > a Japanese font -- note that you could still have told your browser to > use a Japanese font and the page would like fine, but it's that header > in the HTML (do "View Source" in any of the Japanese HTML pages to see it) > that tells your browser to do this automatically. Just FYI, according to HTTP/1.1 specification, using "META" tag for guessing encoding scheme is not the best way. Our pages should return charset parameter in HTTP header (not HTML header). Jun Kuriyama // kuriyama@FreeBSD.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 22:54:29 1999 Delivered-To: freebsd-doc@freebsd.org Received: from omail.emirates.net.ae (omail.emirates.net.ae [194.170.187.1]) by hub.freebsd.org (Postfix) with ESMTP id 8E6DF14F33 for ; Sat, 28 Aug 1999 22:54:26 -0700 (PDT) (envelope-from hyammahi@emirates.net.ae) Received: from pmail.emirates.net.ae by omail.emirates.net.ae (Sun Internet Mail Server sims.3.5.1999.03.02.17.58.p5) with ESMTP id <0FH7009I1POUF2@omail.emirates.net.ae> for freebsd-doc@FreeBSD.org; Sun, 29 Aug 1999 09:53:18 +0400 (GST) Received: from f7g3j5 (twb055.emirates.net.ae) by pmail.emirates.net.ae (Sun Internet Mail Server sims.3.5.1999.03.02.17.58.p5) with SMTP id <0FH700DOBPORDV@pmail.emirates.net.ae> for freebsd-doc@FreeBSD.org; Sun, 29 Aug 1999 09:53:17 +0400 (GST) Date: Sun, 29 Aug 1999 09:46:32 +0400 From: ALi Subject: ayammahi@yahoo.com To: freebsd-doc@FreeBSD.org Reply-To: hyammahi@emirates.net.ae Message-id: <37C8C938.379@emirates.net.ae> MIME-version: 1.0 X-Mailer: Mozilla 3.0 (Win95; I) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Aug 28 23:25:45 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mta1-rme.xtra.co.nz (mta1-rme.xtra.co.nz [203.96.92.1]) by hub.freebsd.org (Postfix) with ESMTP id C164E14EAC for ; Sat, 28 Aug 1999 23:25:40 -0700 (PDT) (envelope-from junkmale@xtra.co.nz) Received: from wocker ([210.55.152.212]) by mta1-rme.xtra.co.nz (InterMail v4.01.01.00 201-229-111) with ESMTP id <19990829063003.UMTJ3442178.mta1-rme@wocker> for ; Sun, 29 Aug 1999 18:30:03 +1200 From: "Dan Langille" Organization: The FreeBSD Diary To: doc@freebsd.org Date: Sun, 29 Aug 1999 18:25:24 +1200 MIME-Version: 1.0 Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT Subject: 4.3.1. Compiling ports from CDROM Reply-To: junkmale@xtra.co.nz X-mailer: Pegasus Mail for Win32 (v3.12a) Message-Id: <19990829063003.UMTJ3442178.mta1-rme@wocker> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I've been reading http://www.freebsd.org/handbook/ports-getting.html and trying to understand how I can install a port using my CD-ROM. At one point, the handbook contains: Then, just cd to the appropriate subdirectory under /cdrom/ports and type make install as usual. I've just tried all four 3.2-RELEASE CDs and I can't find any ports structure under /cdrom/ports which is similar to /usr/ports. Where should I be looking? -- Dan Langille - DVL Software Limited The FreeBSD Diary - http://www.freebsdiary.org/freebsd/ NZ FreeBSD User Group - http://www.nzfug.nz.freebsd.org/ The Racing System - http://www.racingsystem.com/racingsystem.htm unix @ home - http://www.unixathome.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message