From owner-freebsd-doc Sun Jun 25 16:30: 8 2000 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 A35DB37B763 for ; Sun, 25 Jun 2000 16:30:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id QAA28698; Sun, 25 Jun 2000 16:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from santropez.acs.rpi.edu (santropez.acs.rpi.edu [128.113.24.162]) by hub.freebsd.org (Postfix) with ESMTP id DAD0137B579 for ; Sun, 25 Jun 2000 16:28:36 -0700 (PDT) (envelope-from gad@santropez.acs.rpi.edu) Received: (from gad@localhost) by santropez.acs.rpi.edu (8.9.3/8.9.3) id TAA05330; Sun, 25 Jun 2000 19:29:29 -0400 (EDT) (envelope-from gad) Message-Id: <200006252329.TAA05330@santropez.acs.rpi.edu> Date: Sun, 25 Jun 2000 19:29:29 -0400 (EDT) From: Garance A Drosehn Reply-To: gad@eclipse.acs.rpi.edu To: FreeBSD-gnats-submit@freebsd.org Cc: gad@eclipse.acs.rpi.edu X-Send-Pr-Version: 3.2 Subject: docs/19507: Mailing-list search at www.freebsd.org reports the wrong dates Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19507 >Category: docs >Synopsis: Mailing-list search at www.freebsd.org reports the wrong dates >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jun 25 16:30:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Garance A Drosehn >Release: FreeBSD 4.0-STABLE i386 >Organization: RPI; Troy, NY >Environment: Go to http://www.freebsd.org/search/search.html#mailinglists >Description: In the mailing-list search area, pick some keywords likely to get a recent topic. The combination I picked was: SMP instability Matt development and I checked the box for "freebsd-current" and unchecked the one for "freebsd-questions". Then, "Submit Query". If it works for you like it worked for me, you will get a list of at least 25 messages. The top message will (hopefully) be from Matt Dillon. In the listing of matched-messages, it will probably have a somewhat plausible date (I see "-6-2000"). However, look at other messages in the list. There are messages with the exact same subject ("HEADS UP: Destabilization..."), and they are listed has having happened in Sept 1997, May 1998, Mar 1999, and other obviously wrong dates. If you click on one of the messages, the message itself looks fine (ie, there is no reference to the date-listed in the message itself). It looks like that in some cases (all y2k messages?), the message is listed with the date of the previous message in the list. >How-To-Repeat: See above. >Fix: I do not have the slightest idea of where to start looking... I might not mind looking into it, if I knew where to look. >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 Sun Jun 25 23:15:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from azazel.zer0.org (azazel.zer0.org [209.133.53.200]) by hub.freebsd.org (Postfix) with ESMTP id C3A8D37B8F6 for ; Sun, 25 Jun 2000 23:15:35 -0700 (PDT) (envelope-from gsutter@zer0.org) Received: (from gsutter@localhost) by azazel.zer0.org (8.9.3/8.9.2) id XAA83105; Sun, 25 Jun 2000 23:15:25 -0700 (PDT) (envelope-from gsutter@zer0.org) Date: Sun, 25 Jun 2000 23:15:25 -0700 From: Gregory Sutter To: Salvo Cc: err@intergrafix.net, freebsd-doc@FreeBSD.ORG, "Jordan K. Hubbard" Subject: Re: the word demon Message-ID: <20000625231525.F79299@azazel.zer0.org> References: <20000619.120200@bartequi.ottodomain.org> <71377.961383726@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <71377.961383726@localhost>; from jkh@zippy.osd.bsdi.com on Sun, Jun 18, 2000 at 08:02:06PM -0700 Organization: Zer0 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 2000-06-18 20:02 -0700, "Jordan K. Hubbard" wrote: > > What is the defference between the word demon and the word devil? > > There is only one devil whereas there can be many demons. > > Not that either is a relevant question to FreeBSD in any case since we > use a DAEMON. Notice the difference in spelling. It's a greek word > which means "helpful spirit or worker." I suppose the closest english(?) > word would be "genie." If you want to know about _BSD_ Daemons, I'd suggest reading http://www.daemonnews.org/199810/daemon.html for a summary. Greg -- Gregory S. Sutter "I think not," said Descartes... mailto:gsutter@zer0.org and promptly disappeared. http://www.zer0.org/~gsutter/ PGP DSS public key 0x40AE3052 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2: 4:10 2000 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 BDB3937BBEA; Mon, 26 Jun 2000 02:03:58 -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 IAA88190; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00560; Sun, 25 Jun 2000 19:58:48 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:58:48 +0000 From: Nik Clayton To: doc@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: XML/XSL for the Doc. Project Message-ID: <20000625195848.H470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org XML and XSL are slowly maturing, and we will be switching to them at some point in the future (probably 12 to 18 months at this rate is my estimate). As a proof of concept, someone needs to recode doc.docbook.mk using XML tools and stylesheets instead of SGML tools and stylesheets, so we can see how far along things have come. Any volunteers? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2: 6: 8 2000 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 17DCD37BDE5; Mon, 26 Jun 2000 02:05:56 -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 IAA88193; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00536; Sun, 25 Jun 2000 19:55:06 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:55:06 +0000 From: Nik Clayton To: doc@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Splitting the Handbook Message-ID: <20000625195506.E470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This has been on the cards for ages. IMHO, the Handbook, as it stands, is unwieldy. It's too big, it tries to cater to too many audiences (someone installing FreeBSD, someone using FreeBSD, someone trying to develop with FreeBSD, someone who wants to hack on FreeBSD), and there's no one person that 'owns' it. I want to break the Handbook up in to smaller chunks. We're doing this already -- the recent creation of the Porter's Handbook reflects this, as does the work that Jeroen's doing on the Developer's Handbook. [ In fact, if rumour is to be believed, Jim Mock spent most of last night locked in his hotel room putting together a "New Users Handbook" -- given the amount of alcohol on offer that's dedication. ] Ideally, we would have a collection of *true* handbooks. 70-100 pages in length and dealing with one topic at a time. My last proposal for this is still available, at http://people.freebsd.org/~nik/hb/comments.txt and http://people.freebsd.org/~nik/hb/new-layout.txt I also think this would make the job of merging in documentation from other projects (and, in particular, forming a "BSD Documentation Project") considerably easier. With the Handbook as it currently stands, trying to do this would mean that large sections would be marked as OS specific. For example, the 'installing' section. Under this scheme, we would have an "Installation Handbook". This can be different on a per-project basis, and deserves to be. But we would also have a "Printing Handbook" which would have very little OS specific detail. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:10:39 2000 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 AB84037C598; Mon, 26 Jun 2000 02:10:27 -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 IAA88195; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00544; Sun, 25 Jun 2000 19:56:47 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:56:47 +0000 From: Nik Clayton To: doc@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Indexing and glossary Message-ID: <20000625195647.F470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org There are a couple of things missing from the Handbook as it currently stands. 1. An index This is relatively easy to do. You just go through the document marking up terms to appear in the index as foo, and then let the processing tools do their work. There are some problems with this (documented on the docbook.org website), but they shouldn't be insurmountable. BSDi should be able to provide resources to work on this, in the form of a couple of interns. 2. A glossary Much more interesting. Conceptually, the glossary is not much different from the index. You still have to go through the document marking up terms that should be linked to the glossary (using and respectively). Then you actually have to write the glossary, which consists of the terms and definitions. For maintainability, I suggest we do it like this: 1. Go through the Handbook, marking up with and as necessary. That'll probably be those BSDi interns again. 2. Write a program (probably Perl) to go through the document and construct a skeleton glossary. This glossary will contain all the terms that were referred to in the body of the document, but no definitions. 3. Start a project to collection definitions. The clever bit is what happens two months down the line, when you've added some new documentation which wants some new glossary entries. The Perl script that was written at (2) can re-parse the document to create the new glossary entries. In addition, it should be able to parse the (by now populated) glossary, and insert the new entries straight in to it, ready for someone to add definitions. We then have an effective glossary maintenance tool. It's not FreeBSD specific, so the other documentation efforts should be able to leverage off our work. In fact, we can probably take this a step further -- all the documentation projects are going to need a glossary, and why try and reinvent the wheel each time? Someone (probably us) should start a free glossary project. Each documentation project can submit definitions to it, and can pick and choose definitions from other projects as necessary. Anyone want to pick this idea up and run with it? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:12: 4 2000 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 EF2E137BCF2; Mon, 26 Jun 2000 02:11:52 -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 IAA88196; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00524; Sun, 25 Jun 2000 19:53:28 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:53:27 +0000 From: Nik Clayton To: doc@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Sharing the documentation with other systems Message-ID: <20000625195327.D470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Another biggie. There are two major parts to this. All the major free documentation projects are switching to DocBook. Some of them are more advanced along this path than others. So far, I think we're ahead of the curve in terms of getting the toolchain working, and customising the output. This is work that I'd like to share with the other documentation projects wherever possible. By and large, we're doing that just by making the tools and infrastructure we use available via CVSweb. But it certainly can't hurt to have representatives from the FreeBSD Doc. Project on other Doc. Project mailing lists to provide the benefit of our experience where necessary. And, of course, it gives us the opportunity to learn from what the other projects are doing. The second part relates to the actual content. Consider the Handbook. A glance through it will show that there's an *awful* lot of content there that's not really FreeBSD specific. A reasonable chunk isn't even BSD specific. I'd like to share as much of this as possible with the other documentation projects. Intially the other BSD projects, simply because it's going to be easier to manage. But ultimately with some of the non-BSD documentation projects as well. This brings up the issue of how we distinguish the content that *is* specific to different operating systems. Some of you will probably recall an earlier proposal of mine to allow documentation for various versions of FreeBSD to be embedded in the docs, in the form of additional attributes on the majority of elements. For example This para contains text that is only application to versions of FreeBSD between 3.x and 4.x. This para contains text that is only applicable to FreeBSD 2.2.8. it should be relatively easy to extend this model to support different operating systems, so that we could have NetBSD specific paragraphs, BSD/OS specific notes, and so on. BSD/OS will probably be the first to benefit from this. Their current documentation set is being migrated to DocBook by Debbie, and there's definitely content that both systems can share -- I'm waiting the final word on this, but I hope that the BSD/OS documentation will be made available in the same way that FreeBSD's is, and, ideally (at least I think it's ideal) the FreeBSD Handbook and the BSD/OS equivalent can merge quite closely. I had the opportunity to speak to Charles Hannum (NetBSD's big cheese) at Usenix. He suggested I get in touch with www@netbsd.org to kick this idea around with them, which I've done. If you look at the documentation on Netbsd's site they have a document similar to the Handbook, but smaller. However, in certain sections it's much better written than ours, and again, large chunks of it are cross-BSD compatible. Then again, we have more content, and more active translation teams than they do, so we've both got reasons for collaborating. Assuming things go well on this I'll talk to the OpenBSD folks as well. I'm holding off at the moment simply because trying to merge three sets of docs together is going to be bad enough, without bringing in a fourth. However, if someone else wants to step up to the plate and do this then please do, and feel free to bring in anyone you want. This is also going to be affected by another on-going task, that of splitting the Handbook up in to smaller documents. I'll talk about this in a separate message. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:13:57 2000 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 AC18F37BCE1; Mon, 26 Jun 2000 02:13:43 -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 IAA88197; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00508; Sun, 25 Jun 2000 19:50:51 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:50:51 +0000 From: Nik Clayton To: doc@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Images in the documentation Message-ID: <20000625195051.B470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This is one of our top priority issues to resolve. There's a lot of existing documentation that we could bring in to the tree if we have support for images. [ Because someone *always* complains when this is bought up -- NO, I am not suggesting we remove existing text, or the ASCII art images when the documentation is converted to a text-only medium. Images will be an addition to the current documentation, not a replacement for some of it. ] For example, Matt Dillon's VM article in DaemonNews a while back, or Archie Cobb's discussion of Netgraph. Both of these are good examples of well written, useful, technical articles, which we currently lack. They also both rely on images to make it easier to put across certain concepts. There is also a wealth of documentation written by others about FreeBSD on other websites around the world. I'd like to bring these in to the tree wherever possible as well -- if this means bringing on board the original authors as committers (restricted to their own directory under -doc if necessary) then I don't have a problem with that. Currently, our lack of image support is a bottleneck preventing this, and I want it removed ASAP. We hashed out most of the issues in a thread on -doc started by me with the subject "Including images in the documentation". Most of the actual infrastructure concerns were resolved in that thread. What wasn't resolved was the master format we would use for images in the repository. We had settled on PNG for bitmap images. As far as I'm aware, everybody thinks that's a good choice. We haven't settled on a vector format. The two contenders seems to be EPS and SVG. EPS is more widely deployed, and has more tools that can create it. SVG is on the W3C standards track, is XML based, and probably makes it easier to translate text in images. We also have command line tools (even if they do add a 6MB dependency to the docproj tool chain) to convert SVG to EPS (I'm talking about ports/graphics/sketch). [ Newsflash: I've been reading the proceedings of the Freenix track at Usenix, where a discussion of the GNOME Canvas model was presented. Turns out the GNOME guys have another application that reads and writes SVG -- not that I'm suggesting we add GNOME as a dependency in docproj, but there is now more than one free application out there supporting it. Given the GNOME canvas technical model I also think it would be relatively easy for someone to extend to add SVG as a native export format for it, effectively allowing all GNOME applications that use the Canvas to support SVG. ] I had thought that we were pretty much in agreement that SVG was the way to go. Then I talked to Patrick at Usenix, who was vociferously in favour of EPS. Patrick, this is your cue to talk about why EPS would be a better format to use than SVG. From my point of view SVG is a better bet because it's XML based. This makes it easy to write an application to manipulate the data using any of the XML libraries out there -- in particular, Perl and (I believe) Python have good XML support. Here's a very small fragment of SVG: Path for incoming e-mail (POP3) Whichever way you look at it, that's got to be easier to parse than EPS. One way or another, I'd like this wrapped up within a fortnight or so. We still have a few other related issues to discuss, like standards for image sizes, fonts (and font sizes) to use in images, and so on, but these should be fairly easy to do in parallel -- to kick things off, vector images should assume a page width of US Letter or A4 (whichever is thinner), bitmap images should, wherever possible, be no wider than 640 pixels. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:15:11 2000 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 422C737BC3D; Mon, 26 Jun 2000 02:14:48 -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 IAA88198; Mon, 26 Jun 2000 08:25:29 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00552; Sun, 25 Jun 2000 19:58:03 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:58:03 +0000 From: Nik Clayton To: doc@freebsd.org Cc: current@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: XML driver config file to replace LINT Message-ID: <20000625195803.G470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ Sent to -doc, for info, -current for some expert advice on the feasability of this approach with FreeBSD's migration to a kernel consisting only of aggregated devices. ] We have a problem with keeping our documentation up to date. One of the most glaring examples of this is the hardware compatability list. We currently list hardware information in LINT, HARDWARE.TXT, the FAQ, and the Handbook. Any time this information changes it has to be updated in all these places (and possibly more). This does not always happen. I'm thinking of abstracting out our list of supported hardware in to one file, marked up according to an XML DTD. Something like [...] keyboard controller device atkbdc0 at isa? port IO_KBD The keyboard controller; it controls the keyboard and the PS/2 mouse. keyboard device atkbd0 at atkbdc? irq 1 The AT keyboard Specify the built-in keymap Refuse to load a keymap Install a CDEV entry in /dev 0x01 Force detection of keyboard, else we always assume a keyboard 0x02 Don't reset keyboard, useful for some new ThinkPads 0x04 Old-style (XT) keyboard support, useful for older ThinkPads [ That schema is not set in stone, and certainly requires more work. In particular, we probably need "lang" and "encoding" options on the element, to support comments in more than one language. ] LINT would then become a skeletal file for things which don't fit this sort of pattern, and the full LINT would be generated by a script which parsed the above and the skeletal file to generate the full LINT. Another script would parse the above and generate HARDWARE.TXT. And another could parse the above and spit out DocBook for the Handbook and FAQ. Still another (CGI) script could sit on the website. I'm enamoured of BSDi's hardware selection CGI script on their website. You can choose from a drop down list of supported hardware and/or manufacturers, or do a free text search, and get back a formatted list of all the matching hardware, entries for the kernel config file, links back to the manufacturer's website where necessary, and comments about the suitability or otherwise of specific hardware for specific tasks. We could do something similar today without the above, XML stuff, but it would require duplicating the hardware list in yet another place, which would be a bad thing. The solution I'm proposing would keep all the hardware information in one place, where it would be the driver developer's responsibility to maintain. What I don't know is how this scheme fits in with FreeBSD's future direction. From scanning -current I know that the aim is to have a kernel with very few devices compiled in to it -- devices will be probed once, and if the probe runs true the rest of the device driver will be loaded in. In particular, the phrase "config(8) must die" is bandied about with increasing frequency. I assume, however, that there will still be a place for a statically compiled and configured FreeBSD kernel -- embedded devices, or where you don't want the kernel to load certain devices, or whatever. Can -current provide -doc with a roadmap of where we're heading in this respect, and how a scheme like the above should fit in. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:15:56 2000 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 C19AA37BC22; Mon, 26 Jun 2000 02:15:44 -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 IAA88203; Mon, 26 Jun 2000 08:25:30 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id UAA00574; Sun, 25 Jun 2000 20:00:29 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 20:00:29 +0000 From: Nik Clayton To: doc@freebsd.org Cc: committers@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: The website Message-ID: <20000625200029.I470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ Sent to -committers, so they've got fair warning of a couple of my plans ] The website needs a lot of work. It's not that the content is bad by any means, but the organisation and layout makes it difficult to find things, and you have to dig through several levels before you find anything that's changed. Some rough notes based on our Usenix discussions. * We're constrained in what we can do on the website because of the requirement to mirror it around the world. While we could co-locate it somewhere with suitably beefy bandwidth (as other projects do) I'm not sure this is a good idea. I like the fact that people can contribute to the project by providing mirrors. This means that we can't rely on anything that needs a database running -- IMHO it raises the bar for a mirror to particpate to an unacceptably high level. It also brings up also sorts of interesting concerns about how we would go about mirroring information in a database, or finding a database that supports foreign language text sufficiently well. This also means that a huge reliance on CGI scripts is also a bad thing. At the moment mirrors can participate by setting up a fairly simple webserver that just has to serve static content. The few CGIs that we do have all refer back to the main site. If we were to force the mirrors to run the CGI scripts we put a bigger burden on them, both in terms of the computing power required to run the scripts, and also because they will probably (quite reasonably) want to audit them before they run them on their own systems. This limits the amount of dynamic content we can put on the site. However, all is not lost. We already rebuild the website twice a day. This means that twice a day the content on our pages can change, or can be generated at build-time. It's not quite the same as truly dynamic content, but it's a fair compromise. * We should be reusing the orange left hand bar across all the pages. It's an accepted design standard on many websites, and there's no reason to be gratuitously different from the crowd unless you're trying to win design awards. If you take a look at http://www.demon.net/ you'll see how their left side navigation bar expands and contracts as you move through the site, showing you where you are in the site, and useful places you can go from there. I like this. It's also not too programmatically difficult to do using our SGML tools. * We might want to give each mailing list its own home page. I knocked up a rough prototype of this a while back, which you can find at http://people.freebsd.org/~nik/lists/. It needs work (in particular, it needs integrating in to a complete site plan, rather than the rough proof of concept it is now) but it's (IMHO) a good way of organising a lot of our content. * The front page (and some related pages) have *got* to change more frequently. At the moment you can come to the FreeBSD home page once a day, or once a week, and to the uninitiated the project may as well be dead. There have been no significant content changes in months. A redesign of the website has to fix this. Some ideas that were discussed at Usenix include: * Providing a place to showcase a "Project of the week" on the front page (or "Project of the day", or whatever). This would link to one of the FreeBSD development projects, with a brief description and a pointer to the project's home page. * As above, but for a "Committer of the Week". IMHO, each committer could write up a couple of paragraphs about who they are, how they got involved in FreeBSD, what they're working on, and so on. If I had my way, failure to provide this after a reasonable amount of time (6 weeks say) would be grounds to get the commit bit removed. The individual chunks of the project don't exist in a vacuum, and IMHO all committers should be expected to be able to do this, given reasonable notice. I realise that might be a bit radical for some. On the other hand, it does provide an effective way of weeding out the dead wood that's been discussed. . . * On each build, generate links to BSD stories on Slashdot, DaemonNews, BSD Today, the O'Reilly Dev Centre, and others. Yes, it's the "P" word -- we should be a BSD Portal. * Provide a projects statistics page. This should contain all sorts of administrivia, something like: Number of committers, and growth rate ("At this rate, we will have 300 committers in six months time") Number of ports, and growth rate (according to Satoshi, we should have a million ports in ten years time, at the current rate). Number of mailing list subscribers, and growth rate. Number of messages to each mailing list in the past 24 hours. Number of messages sent through hub in total in the past 24 hours. . . Number of commits to the tree in the past 24 hours, and 7 days. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:16:36 2000 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 4284C37BD6E; Mon, 26 Jun 2000 02:16:23 -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 IAA88204; Mon, 26 Jun 2000 08:25:30 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA00516; Sun, 25 Jun 2000 19:52:03 GMT (envelope-from nik) Date: Sun, 25 Jun 2000 19:52:03 +0000 From: Nik Clayton To: doc@freebsd.org Cc: hackers@freebsd.org, jkh@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Documentation selection in sysinstall Message-ID: <20000625195203.C470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ Going to -doc where it's pertinent, -hackers where it might find someone who's prepared to do the work, and jkh for any expert commentary he feels like tossing in. And while I've got Jordan's attention -- did the last attempt at re-writing sysinstall generate any specification documents? If nothing else, they'd be useful content for the doc project. ] [ I didn't go through this at Usenix -- not enough time ] The documentation is now being built and made available as FreeBSD packages (one package per combination of document, language, and output format). This means we could do away with the "doc" distribution when installing FreeBSD, and instead allow the user to choose which documentation packages they want to install. In theory, this is a doddle. sysinstall already lets the user choose from packages to install. In practice, I think it's a little more difficult, because: 1. [ I haven't run the code to confirm this, not having a network connection at the moment. ] When you do the "post-install" configure via sysinstall, it wants to grab the INDEX file from somewhere (CDROM, the 'net, or whatever) in order to present you with an up-to-date list of packages to install. The doc package building doesn't work like that. There is no INDEX file for sysinstall to grok. We need to find some other way for sysinstall to get the list of docs, languages, and formats that are supported it. This shouldn't be too hard -- looking in /pub/FreeBSD/doc/packages on the FTP site gives a complete list of what's currently built in terms of languages and output formats, and the filenames are easily parseable. 2. We need to find a UI model that allows the user to efficiently select the language and formats they want to install. I'm thinking of initially presenting a dialog box that looks like this: ------------------------------------------------------------ Documentation is available in the following languages: English Spanish French Japanese Chinese ------------------------------------------------------------ with the list extending as necessary, based on what sysinstall found on the FTP site. After the user has chosen a language, then present them with a list like this: ------------------------------------------------------------ Now choose the documentation you would like to install, and the formats you would like to use. HTML HTML Text PS PDF PDB RTF Split Books Handbook [ ] [X] [ ] [ ] [ ] [ ] [ ] FAQ [X] [X] [ ] [ ] [ ] [ ] [ ] Porter's Handbook [ ] [ ] [ ] [X] [ ] [ ] [ ] [... and so on ...] ------------------------------------------------------------ From my reading of dialog(3) I believe this to be, uh, optimistic at best. I've also glossed over the issue of how sysinstall turns "porters-handbook" in a filename to "Porter's Handbook" on screen. Thinking about it, we will probably need an INDEX. file that maps filenames to titles -- we should be able to generate this when we build the packages by grabbing the first element from a document. The alternative to a display like this would seem to be a fairly horrendous nest of menus and sub-menus that the user would have to navigate through. That's about where I am in my thinking about this so far. Alternative viewpoints, suggestions, offers to do the work, and prototypes are gratefully received. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 2:35: 3 2000 Delivered-To: freebsd-doc@freebsd.org Received: from pike.osd.bsdi.com (pike.osd.bsdi.com [204.216.28.222]) by hub.freebsd.org (Postfix) with ESMTP id 5DFBA37BC22; Mon, 26 Jun 2000 02:35:00 -0700 (PDT) (envelope-from murray@osd.bsdi.com) Received: from localhost (murray@localhost) by pike.osd.bsdi.com (8.9.3/8.9.3) with ESMTP id CAA99856; Mon, 26 Jun 2000 02:34:38 -0700 (PDT) (envelope-from murray@osd.bsdi.com) Date: Mon, 26 Jun 2000 02:34:38 -0700 (PDT) From: Murray Stokely <murray@osd.bsdi.com> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary In-Reply-To: <20000625195647.F470@kilt.nothing-going-on.org> Message-ID: <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, 25 Jun 2000, Nik Clayton wrote: % This is relatively easy to do. You just go through the document marking % up terms to appear in the index as <indexterm>foo</indexterm>, and then % let the processing tools do their work. There are some problems with % this (documented on the docbook.org website), but they shouldn't be % insurmountable. % % BSDi should be able to provide resources to work on this, in the form of % a couple of interns. Just as a heads up for everyone I'm going to be coordinating the work in this area with 3 part-time interns we've hired for the summer. Hopefully we should see some results by the end of this week. (I'll bounce the first couple of changes through Nik and Jim) Also, are there any plans to upgrade to a newer version of DocBook? 4.1 was released a few days ago. I've made a port and am waiting to here back from Satoshi before committing. Murray Stokely To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3: 9:31 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 9F62537BC3D for <doc@FreeBSD.org>; Mon, 26 Jun 2000 03:09:28 -0700 (PDT) (envelope-from kuriyama@FreeBSD.org) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5QA9Xh74413 for <doc@freebsd.org>; Mon, 26 Jun 2000 19:09:34 +0900 (JST) Date: Mon, 26 Jun 2000 19:09:33 +0900 Message-ID: <7mwvjc4uua.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama <kuriyama@FreeBSD.org> To: doc@FreeBSD.org Subject: Re: XML/XSL for the Doc. Project In-Reply-To: In your message of "26 Jun 2000 09:31:23 GMT" <20000625195848.H470@kilt.nothing-going-on.org> References: <20000625195848.H470@kilt.nothing-going-on.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org At 26 Jun 2000 09:31:23 GMT, nik wrote: > XML and XSL are slowly maturing, and we will be switching to them at some > point in the future (probably 12 to 18 months at this rate is my estimate). I think some of recent XML tools requires wchar.h support to compile. These stuff are not yet in the base system of FreeBSD. But research work for XML/XSL should be continued... -- Jun Kuriyama <kuriyama@FreeBSD.org> // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:27:41 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 2709037B846; Mon, 26 Jun 2000 03:27:33 -0700 (PDT) (envelope-from kuriyama@FreeBSD.org) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5QARdh82029; Mon, 26 Jun 2000 19:27:39 +0900 (JST) Date: Mon, 26 Jun 2000 19:27:39 +0900 Message-ID: <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama <kuriyama@FreeBSD.org> To: doc@FreeBSD.org, current@FreeBSD.org Subject: Re: XML driver config file to replace LINT In-Reply-To: In your message of "26 Jun 2000 09:33:30 GMT" <20000625195803.G470@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org At 26 Jun 2000 09:33:30 GMT, nik wrote: > We have a problem with keeping our documentation up to date. One of the > most glaring examples of this is the hardware compatability list. We > currently list hardware information in LINT, HARDWARE.TXT, the FAQ, and the > Handbook. Any time this information changes it has to be updated in all > these places (and possibly more). This does not always happen. I don't like "Everything should be written in XML" type thought. But consept for automatic updating of document would be fine. So first of all, we (documentation project) should develop prototype tool to achive that conversion. And we should keep that master text simple to ease modification by hackers. If we force to write complex markups, hackers will *forget* to update that master text. :-) > LINT would then become a skeletal file for things which don't fit this > sort of pattern, and the full LINT would be generated by a script which > parsed the above and the skeletal file to generate the full LINT. I think developpers may dislike to install doc toolchain to build LINT file. $CVSROOT/src tree should not depend on doc toolchain. Another idea is to write some script to convert LINT to LINT.xml for documentation. And website and documents depend on it. Yes, this is not ideal world from the point of SGML/XML view, but we should not bother hackers' development in the source tree. -- Jun Kuriyama <kuriyama@FreeBSD.org> // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:41:49 2000 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 5C46237B7C5 for <doc@freebsd.org>; Mon, 26 Jun 2000 03:41:43 -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 KAA10381 for doc@freebsd.org; Mon, 26 Jun 2000 10:58:29 +0100 (BST) (envelope-from nik) Date: Sun, 25 Jun 2000 19:49:04 +0000 From: Nik Clayton <nik@freebsd.org> To: docs@freebsd.org Cc: dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: The docs go to Usenix Message-ID: <20000625194904.A470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi guys, *** IMPORTANT *** IMPORTANT *** IMPORTANT *** IMPORTANT *** IMPORTANT *** The main reason I'm doing this is so that it can act as a springboard for anyone else who's interested to get down and contribute. I'm already swamped with work, and I get the impression sometimes that people are nervous of contributing for fear of stepping on my toes, as if the doc project was my own private domain. That's emphatically not the case. If you want to work on any of the projects I'm going to describe in the next few messages, please step forward and say so. About the only thing I would ask is that you commit to producing stuff for review every so often so that I (and anyone else) can comment before you (potentially) invest a lot of time in something that might be implemented another way -- peer review, and all that. *** IMPORTANT *** IMPORTANT *** IMPORTANT *** IMPORTANT *** IMPORTANT *** "Join up" they said. "Come to Usenix" they said, "it'll be fun, glamourous, and exciting!" I'm trying hard to remember this as I sit in LA airport waiting for my flight back (current delay, three hours and counting). Anyway, this gives me as good an opportunity as any to write up a report on what happened at Usenix that was -doc related. During the discussions a number of different project ideas came up. I'm going to split these up in to several different messages, so that each project can get a message thread of its own. Anyway, some meta-discussion. At Usenix I got the opportunity to meet up with Debbie Lidl (now responsible for BSDi's documentation), Jim Mock ("Mr. Handbook" for the past six months or more), Patrick Powell (author of LPRng, and interested in contributing), Bill Paul (fingers all over the networking code, and interested in working on the website), Ceren Ercen ("FreeBSD's Strange Attractor", interested in contributing), and Ryan (damn, don't know your last name, it's depressing when you only know people by their e-mail address, also interested in contributing). I also managed to miss (due to more flight delays) Murray Stokely, also from BSDi, who's been looking at some doc stuff. I've cc'd all of them on these messages. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:43:37 2000 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 019F437B594; Mon, 26 Jun 2000 03:43:30 -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 LAA16018; Mon, 26 Jun 2000 11:43:07 +0100 (BST) (envelope-from nik) Date: Mon, 26 Jun 2000 11:43:07 +0100 From: Nik Clayton <nik@freebsd.org> To: Murray Stokely <murray@osd.bsdi.com> Cc: Nik Clayton <nik@freebsd.org>, doc@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary Message-ID: <20000626114306.A462@catkin.nothing-going-on.org> References: <20000625195647.F470@kilt.nothing-going-on.org> <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com>; from murray@osd.bsdi.com on Mon, Jun 26, 2000 at 02:34:38AM -0700 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 02:34:38AM -0700, Murray Stokely wrote: > Just as a heads up for everyone I'm going to be coordinating the > work in this area with 3 part-time interns we've hired for the summer. > Hopefully we should see some results by the end of this week. (I'll > bounce the first couple of changes through Nik and Jim) Great. > Also, are there any plans to upgrade to a newer version of DocBook? > 4.1 was released a few days ago. I've made a port and am waiting to > here back from Satoshi before committing. The port should be fine. Upgrading the docs to use it is relatively trivial. Once I've got my hands on the port and tested that everything builds OK I'll upgrade. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:49:50 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 6CCB637B61D; Mon, 26 Jun 2000 03:49:43 -0700 (PDT) (envelope-from kuriyama@FreeBSD.org) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5QAnmh82158; Mon, 26 Jun 2000 19:49:49 +0900 (JST) Date: Mon, 26 Jun 2000 19:49:48 +0900 Message-ID: <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama <kuriyama@FreeBSD.org> To: doc@FreeBSD.org, committers@FreeBSD.org Subject: Re: The website In-Reply-To: In your message of "26 Jun 2000 09:33:42 GMT" <20000625200029.I470@kilt.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org At 26 Jun 2000 09:33:42 GMT, nik wrote: > This also means that a huge reliance on CGI scripts is also a bad > thing. At the moment mirrors can participate by setting up a fairly > simple webserver that just has to serve static content. The few CGIs > that we do have all refer back to the main site. If we were to force > the mirrors to run the CGI scripts we put a bigger burden on them, both > in terms of the computing power required to run the scripts, and also > because they will probably (quite reasonably) want to audit them before > they run them on their own systems. I think so. We should reduce unneeded CGI scripts but this check should be done carefully. I think current CGI set in www.FreeBSD.org is quite minimal and difficult to replace with static contents. I'd like to see a list of what part of CGI should be replaced. > This limits the amount of dynamic content we can put on the site. > However, all is not lost. We already rebuild the website twice a day. > This means that twice a day the content on our pages can change, or can > be generated at build-time. It's not quite the same as truly dynamic > content, but it's a fair compromise. I don't know about the machine load of web building, but it is difficult to build web stuff more frequently? Japanese web server re-builds contents once per an hour, and this helps visitors to see latest news. (like announcements, ftp/cvsup/www site trouble, seminor informations, etc.) > * We should be reusing the orange left hand bar across all the pages. > It's an accepted design standard on many websites, and there's no > reason to be gratuitously different from the crowd unless you're trying > to win design awards. > > If you take a look at http://www.demon.net/ you'll see how their left > side navigation bar expands and contracts as you move through the site, > showing you where you are in the site, and useful places you can go > from there. > > I like this. It's also not too programmatically difficult to do using > our SGML tools. I'm not expert on web design, but this should be reviewed widely before replacing. > * We might want to give each mailing list its own home page. I knocked > up a rough prototype of this a while back, which you can find at > http://people.freebsd.org/~nik/lists/. It needs work (in particular, > it needs integrating in to a complete site plan, rather than the rough > proof of concept it is now) but it's (IMHO) a good way of organising a > lot of our content. Yeah, there stuff is good candidate to be written in XML as original source? :-) > * The front page (and some related pages) have *got* to change more > frequently. At the moment you can come to the FreeBSD home page once a > day, or once a week, and to the uninitiated the project may as well be > dead. Agreed. IMHO, top page should includes some latest news. > * Providing a place to showcase a "Project of the week" on the front > page (or "Project of the day", or whatever). This would link to one > of the FreeBSD development projects, with a brief description and a > pointer to the project's home page. > > * As above, but for a "Committer of the Week". IMHO, each committer > could write up a couple of paragraphs about who they are, how they > got involved in FreeBSD, what they're working on, and so on. I think there ideas are difficult to continue in long term. Many hackers don't like writing there contents. > If I had my way, failure to provide this after a reasonable amount of > time (6 weeks say) would be grounds to get the commit bit removed. > The individual chunks of the project don't exist in a vacuum, and > IMHO all committers should be expected to be able to do this, given > reasonable notice. Of course, this is ideal. But should we remove someone's commit privs who only have time to hack source code, not document? Yes, documents should be written by developpers who writes the code, but real world is more difficult, isn't it? > * On each build, generate links to BSD stories on Slashdot, DaemonNews, > BSD Today, the O'Reilly Dev Centre, and others. > > Yes, it's the "P" word -- we should be a BSD Portal. Hmmm, it is good idea but it can be done automatically? -- Jun Kuriyama <kuriyama@FreeBSD.org> // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:50:26 2000 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 9BE1B37B8A6; Mon, 26 Jun 2000 03:50:18 -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 LAA16943; Mon, 26 Jun 2000 11:50:10 +0100 (BST) (envelope-from nik) Date: Mon, 26 Jun 2000 11:50:09 +0100 From: Nik Clayton <nik@freebsd.org> To: Jun Kuriyama <kuriyama@FreeBSD.org> Cc: doc@FreeBSD.org, current@FreeBSD.org Subject: Re: XML driver config file to replace LINT Message-ID: <20000626115008.B462@catkin.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <7mvgyw4u04.wl@waterblue.imgsrc.co.jp>; from kuriyama@FreeBSD.org on Mon, Jun 26, 2000 at 07:27:39PM +0900 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 07:27:39PM +0900, Jun Kuriyama wrote: > So first of all, we (documentation project) should develop prototype > tool to achive that conversion. > > And we should keep that master text simple to ease modification by > hackers. If we force to write complex markups, hackers will *forget* > to update that master text. :-) The aim is that we have one file that describes the drivers -- this file will be used by us to keep the documentation up to date, but it will also be used by the system -- if the driver writer doesn't update this file then the system won't know about their driver, and won't build it. They'll *have* to keep it up to date. > > LINT would then become a skeletal file for things which don't fit this > > sort of pattern, and the full LINT would be generated by a script which > > parsed the above and the skeletal file to generate the full LINT. > > I think developpers may dislike to install doc toolchain to build > LINT file. $CVSROOT/src tree should not depend on doc toolchain. Agreed. But Perl (already in the base system) plus a Perl XML module should be OK? > Another idea is to write some script to convert LINT to LINT.xml for > documentation. And website and documents depend on it. Yes, this is > not ideal world from the point of SGML/XML view, but we should not > bother hackers' development in the source tree. I disagree. We're not Linux, where people can throw in code without thought to the wider consequences -- one of the commitments you should make (that's a generic "you" there, not you specifically) as a FreeBSD committer is to maintain the documentation that's affected by your changes. A look at HARDWARE.TXT shows that (with a few notable exceptions) the FreeBSD Developer Community at large is *not* keeping it up to date. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 3:53: 0 2000 Delivered-To: freebsd-doc@freebsd.org Received: from critter.freebsd.dk (critter.freebsd.dk [212.242.40.131]) by hub.freebsd.org (Postfix) with ESMTP id 7423E37B808; Mon, 26 Jun 2000 03:52:52 -0700 (PDT) (envelope-from phk@critter.freebsd.dk) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.9.3/8.9.3) with ESMTP id MAA17148; Mon, 26 Jun 2000 12:52:43 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: Nik Clayton <nik@FreeBSD.org> Cc: doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website In-reply-to: Your message of "Sun, 25 Jun 2000 20:00:29 -0000." <20000625200029.I470@kilt.nothing-going-on.org> Date: Mon, 26 Jun 2000 12:52:43 +0200 Message-ID: <17146.962016763@critter.freebsd.dk> From: Poul-Henning Kamp <phk@critter.freebsd.dk> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik, Go For It! I think our web-page is lying badly about the activity level in the project. A few comments: * All your suggestions sound great. * Database driven content is OK, as long as it is not the main page, currently our cvs-web and search engines work OK in the overall mirror strategy. * Other topic for dynamic content: supported hardware. * Other topic for dynamic content: I would like if cvsweb somehow could locate all files relevant to a specific commit, I know this is somewhat difficult but It would be nice anyway. * Other topic for dynamic content: HTML'ed page with the last 24h of commit logs, ie: pointers into cvsweb to see the diffs. * Other topic for dynamic content: A place to keep track of patchsets up for review, test and comment. Ie: submitter provides patch and comments and a page is created, linked to from the patchindex and it is added to the "new or updated" patches. submitter can update patch as it develops. One way would be to define a convention like: $HOME/review/$patchname/{README,*} I would LOVE to see the day when www.freebsd.org would be the first page I turn to in the morning. -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD coreteam member | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 4: 6:10 2000 Delivered-To: freebsd-doc@freebsd.org Received: from elixir.e.kth.se (elixir.e.kth.se [130.237.48.5]) by hub.freebsd.org (Postfix) with ESMTP id 40B6E37B808; Mon, 26 Jun 2000 04:05:53 -0700 (PDT) (envelope-from kaj@e.kth.se) Received: from alumoklyuchevskit.e.kth.se (alumoklyuchevskit.e.kth.se [130.237.48.15]) by elixir.e.kth.se (8.9.3/8.9.3) with ESMTP id NAA22144; Mon, 26 Jun 2000 13:05:44 +0200 (MET DST) Received: (from kaj@localhost) by alumoklyuchevskit.e.kth.se (8.9.3/8.9.3) id NAA08159; Mon, 26 Jun 2000 13:05:44 +0200 (MET DST) X-Authentication-Warning: alumoklyuchevskit.e.kth.se: kaj set sender to kaj@e.kth.se using -f To: Nik Clayton <nik@FreeBSD.ORG> Cc: doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary References: <20000625195647.F470@kilt.nothing-going-on.org> From: Rasmus Kaj <kaj@Raditex.se> Cc: Rasmus Kaj <kaj@Raditex.se> Organization: Raditex AB - http://Raditex.se/ Date: 26 Jun 2000 13:05:44 +0200 In-Reply-To: Nik Clayton's message of "Sun, 25 Jun 2000 19:56:47 +0000" Message-ID: <rqcu2egya5z.fsf@alumoklyuchevskit.e.kth.se> Lines: 22 User-Agent: Gnus/5.0803 (Gnus v5.8.3) Emacs/20.6 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "NC" == Nik Clayton <nik@FreeBSD.ORG> writes: NC> In fact, we can probably take this a step further -- all the NC> documentation projects are going to need a glossary, and why try and NC> reinvent the wheel each time? NC> Someone (probably us) should start a free glossary project. Each NC> documentation project can submit definitions to it, and can pick and NC> choose definitions from other projects as necessary. Anyone want to NC> pick this idea up and run with it? How would this new project differ from FOLDOC [1] (Free OnLine Dictionary Of Computing) ? Or might FOLDOC be a good project to join forces with on this? [1] http://www.InstantWeb.com/foldoc/foldoc.cgi?FOLDOC -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ Multiple exclamation marks are a sure sign of a diseased mind!!! \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 4:43:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from peach.ocn.ne.jp (peach.ocn.ne.jp [210.145.254.87]) by hub.freebsd.org (Postfix) with ESMTP id 200F037BD44; Mon, 26 Jun 2000 04:43:48 -0700 (PDT) (envelope-from dcs@newsguy.com) Received: from newsguy.com (p18-dn02kiryunisiki.gunma.ocn.ne.jp [211.0.245.83]) by peach.ocn.ne.jp (8.9.1a/OCN/) with ESMTP id UAA05069; Mon, 26 Jun 2000 20:43:43 +0900 (JST) Message-ID: <3957413B.83D5DEA4@newsguy.com> Date: Mon, 26 Jun 2000 20:40:44 +0900 From: "Daniel C. Sobral" <dcs@newsguy.com> X-Mailer: Mozilla 4.7 [en] (Win98; I) X-Accept-Language: en,pt-BR,ja MIME-Version: 1.0 To: Jun Kuriyama <kuriyama@FreeBSD.ORG> Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Jun Kuriyama wrote: > And we should keep that master text simple to ease modification by > hackers. If we force to write complex markups, hackers will *forget* > to update that master text. :-) I'm not sure I would *forget* it, but I my indulge in "forget"ing it. :-) -- Daniel C. Sobral (8-DCS) dcs@newsguy.com dcs@freebsd.org capo@the.great.underground.bsdconpiracy.org Windows works, for sufficently small values of "works". To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 5:50: 5 2000 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 07DCD37BCE5 for <freebsd-doc@freebsd.org>; Mon, 26 Jun 2000 05:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id FAA55498; Mon, 26 Jun 2000 05:50:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from ccm.gs.niigata-u.ac.jp (ccm.gs.niigata-u.ac.jp [133.35.90.16]) by hub.freebsd.org (Postfix) with ESMTP id 6A49537B86F for <FreeBSD-gnats-submit@freebsd.org>; Mon, 26 Jun 2000 05:45:15 -0700 (PDT) (envelope-from si006@ccm.gs.niigata-u.ac.jp) Received: from ouroboros.ccm (ouroboros.ccm [172.20.1.5]) by ccm.gs.niigata-u.ac.jp (8.9.3/3.7W) with ESMTP id WAA29569 for <FreeBSD-gnats-submit@freebsd.org>; Mon, 26 Jun 2000 22:00:25 +0900 Received: by ouroboros.ccm (Postfix, from userid 3047) id A907C1FC1; Mon, 26 Jun 2000 21:45:12 +0900 (JST) Message-Id: <20000626124512.A907C1FC1@ouroboros.ccm> Date: Mon, 26 Jun 2000 21:45:12 +0900 (JST) From: si006@ccm.gs.niigata-u.ac.jp Reply-To: si006@ccm.gs.niigata-u.ac.jp To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19520: typo in a release note Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19520 >Category: docs >Synopsis: typo in a release note >Confidential: no >Severity: serious >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jun 26 05:50:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Shun SUZUKI >Release: FreeBSD 3.4-RELEASE i386 >Organization: Niigata University >Environment: FreeBSD ouroboros 3.4-RELEASE FreeBSD 3.4-RELEASE #2: Tue Mar 28 15:55:14 JST 2000 shun@ouroboros:/home3/src/sys/compile/OUROBOROS i386 >Description: maybe a conversion miss in www/en/releases/3.5R/notes.sgml from 3.4R/notes.sgml >How-To-Repeat: see and check the diff diff -u www/en/releases/3.4R/notes.sgml www/en/releases/3.5R/notes.sgml >Fix: --- notes.sgml.orig Mon Jun 26 20:40:04 2000 +++ notes.sgml Mon Jun 26 20:41:05 2000 @@ -149,7 +149,7 @@ Adaptec 1535 ISA SCSI controllers Adaptec 154x series ISA SCSI controllers Adaptec 174x series EISA SCSI controller in standard and enhanced mode. -Adaptec 274X/284X/2920C/294x/2950/3.50/3950 (Narrow/Wide/Twin) series +Adaptec 274X/284X/2920C/294x/2950/3940/3950 (Narrow/Wide/Twin) series EISA/VLB/PCI SCSI controllers. Adaptec AIC7850, AIC7860, AIC7880, AIC789x, on-board SCSI controllers. Adaptec 1510 series ISA SCSI controllers (not for bootable devices) @@ -293,7 +293,7 @@ Winbond W89C840F fast Ethernet NICs including the following: Trendware TE100-PCIE -VIA Technologies VT3.53 "Rhine I" and VT86C100A "Rhine II" fast Ethernet +VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast Ethernet NICs including the following: Hawking Technologies PN102TX D-Link DFE530TX @@ -390,7 +390,7 @@ - RFC 1626, "Default IP MTU for use over ATM AAL5" - RFC 1755, "ATM Signaling Support for IP over ATM" - RFC 2225, "Classical IP and ARP over ATM" - - RFC 23.5, "Server Cache Synchronization Protocol (SCSP)" + - RFC 2334, "Server Cache Synchronization Protocol (SCSP)" - Internet Draft draft-ietf-ion-scsp-atmarp-00.txt, "A Distributed ATMARP Service Using SCSP" >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 Jun 26 6:44:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mailout03.sul.t-online.com (mailout03.sul.t-online.com [194.25.134.81]) by hub.freebsd.org (Postfix) with ESMTP id 65B2137B5DE; Mon, 26 Jun 2000 06:44:51 -0700 (PDT) (envelope-from Meerwaldt@t-online.de) Received: from fwd04.sul.t-online.com by mailout03.sul.t-online.com with smtp id 136ZBW-0005Ro-08; Mon, 26 Jun 2000 15:44:22 +0200 Received: from server.wes.mee.com (320044045192-0001@[62.157.22.212]) by fwd04.sul.t-online.com with esmtp id 136ZBM-0S5BgLC; Mon, 26 Jun 2000 15:44:12 +0200 Received: from localhost (localhost [127.0.0.1]) by server.wes.mee.com (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id PAA00868; Mon, 26 Jun 2000 15:28:13 +0200 (CEST) Date: Mon, 26 Jun 2000 15:28:13 +0200 (CEST) From: Meerwaldt@t-online.de (Frederik Meerwaldt) Reply-To: fm_sendthere@gmx.de To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Splitting the Handbook In-Reply-To: <20000625195506.E470@kilt.nothing-going-on.org> Message-ID: <Pine.BSF.4.21.0006261525530.845-100000@server.wes.mee.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Sender: 320044045192-0001@t-dialin.net Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi! the idea wouldn't be bad, but I have one suggestion: Please put all sets of the handbook in one .tar.gz file together, so that somebody can download everything at one time, too. That's what I personally miss at many Handbooks. There are 10 Sets or something like that on the homepage, but there's no way, that I can download everything at one time, too. Regards, Freddy To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 8: 5:39 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sr14.nsw-remote.bigpond.net.au (sr14.nsw-remote.bigpond.net.au [24.192.3.29]) by hub.freebsd.org (Postfix) with ESMTP id E72FE37B97C for <doc@FreeBSD.ORG>; Mon, 26 Jun 2000 08:05:27 -0700 (PDT) (envelope-from a.reilly@lake.com.au) Received: from areilly.bpc-users.org (CPE-144-132-171-71.nsw.bigpond.net.au [144.132.171.71]) by sr14.nsw-remote.bigpond.net.au (Pro-8.9.3/8.9.3) with SMTP id WAA22221 for <doc@FreeBSD.ORG>; Mon, 26 Jun 2000 22:32:15 +1000 (EST) Received: (qmail 98387 invoked by uid 1000); 26 Jun 2000 12:32:14 -0000 From: "Andrew Reilly" <a.reilly@lake.com.au> Date: Mon, 26 Jun 2000 22:32:14 +1000 To: "Daniel C. Sobral" <dcs@newsguy.com> Cc: Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000626223214.A98107@gurney.reilly.home> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <3957413B.83D5DEA4@newsguy.com>; from dcs@newsguy.com on Mon, Jun 26, 2000 at 08:40:44PM +0900 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 08:40:44PM +0900, Daniel C. Sobral wrote: > Jun Kuriyama wrote: > > > And we should keep that master text simple to ease modification by > > hackers. If we force to write complex markups, hackers will *forget* > > to update that master text. :-) > > I'm not sure I would *forget* it, but I my indulge in "forget"ing it. > :-) How about a couple of fields in the driver source itself, along the lines of http://publicsource.apple.com/projects/headerdoc/ If it's part of the source that the developers are working with, then it's more likely to stay "right". Of course we all know that comment bugs exist. -- Andrew To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 8:46:53 2000 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 3EEAB37B5C7; Mon, 26 Jun 2000 08:46:52 -0700 (PDT) (envelope-from jkh@FreeBSD.org) Received: (from jkh@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA60250; Mon, 26 Jun 2000 08:46:51 -0700 (PDT) (envelope-from jkh@FreeBSD.org) Date: Mon, 26 Jun 2000 08:46:51 -0700 (PDT) From: <jkh@FreeBSD.org> Message-Id: <200006261546.IAA60250@freefall.freebsd.org> To: bmah@cisco.com, jkh@FreeBSD.org, freebsd-doc@freebsd.org Subject: Re: docs/19495: [patch] Fix src/release/texts/README.TXT for RELENG_4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: [patch] Fix src/release/texts/README.TXT for RELENG_4 State-Changed-From-To: open->closed State-Changed-By: jkh State-Changed-When: Mon Jun 26 08:46:44 PDT 2000 State-Changed-Why: Applied, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=19495 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 8:49: 3 2000 Delivered-To: freebsd-doc@freebsd.org Received: from obie.softweyr.com (obie.softweyr.com [204.68.178.33]) by hub.freebsd.org (Postfix) with ESMTP id 5826B37B975; Mon, 26 Jun 2000 08:48:56 -0700 (PDT) (envelope-from wes@softweyr.com) Received: from softweyr.com (Foolstrustident!@homer.softweyr.com [204.68.178.39]) by obie.softweyr.com (8.8.8/8.8.8) with ESMTP id JAA21553; Mon, 26 Jun 2000 09:46:46 -0600 (MDT) (envelope-from wes@softweyr.com) Message-ID: <39577B4E.FA0D4C4D@softweyr.com> Date: Mon, 26 Jun 2000 09:48:30 -0600 From: Wes Peters <wes@softweyr.com> Organization: Softweyr LLC X-Mailer: Mozilla 4.7 [en] (X11; U; FreeBSD 4.0-STABLE i386) X-Accept-Language: en MIME-Version: 1.0 To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, core@deamonnews.org.xylan.com Subject: Re: The website References: <17146.962016763@critter.freebsd.dk> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Poul-Henning Kamp wrote: > > Nik, > > Go For It! > > I think our web-page is lying badly about the activity level in the > project. > > A few comments: > > * All your suggestions sound great. > > * Database driven content is OK, as long as it is not the main page, > currently our cvs-web and search engines work OK in the overall > mirror strategy. > > * Other topic for dynamic content: supported hardware. > > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. > > * Other topic for dynamic content: HTML'ed page with the last 24h > of commit logs, ie: pointers into cvsweb to see the diffs. > > * Other topic for dynamic content: A place to keep track of patchsets > up for review, test and comment. Ie: submitter provides patch and > comments and a page is created, linked to from the patchindex and > it is added to the "new or updated" patches. submitter can update > patch as it develops. One way would be to define a convention like: > $HOME/review/$patchname/{README,*} > > I would LOVE to see the day when www.freebsd.org would be the first > page I turn to in the morning. Many of these would be great information for DaemonNews to carry, especially the previous 24 hours of commits and supported hardware. The CVSweb related items and patchsets are perhaps somewhat less suitable for DN. -- "Where am I, and what am I doing in this handbasket?" Wes Peters Softweyr LLC wes@softweyr.com http://softweyr.com/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 9:37: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.osd.bsdi.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 9821837B852; Mon, 26 Jun 2000 09:37:02 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.osd.bsdi.com (8.9.3/8.9.3) with ESMTP id JAA02887; Mon, 26 Jun 2000 09:37:40 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org, hackers@freebsd.org, jkh@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Documentation selection in sysinstall In-reply-to: Your message of "Sun, 25 Jun 2000 19:52:03 -0000." <20000625195203.C470@kilt.nothing-going-on.org> Date: Mon, 26 Jun 2000 09:37:40 -0700 Message-ID: <2884.962037460@localhost> From: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > And while I've got Jordan's attention -- did the last attempt at > re-writing sysinstall generate any specification documents? If nothing > else, they'd be useful content for the doc project. ] No, this is one of the items on my TODO list which I really really really have to get to soon or we'll never get Son Of Sysinstall finished. > In theory, this is a doddle. sysinstall already lets the user choose from > packages to install. In practice, I think it's a little more difficult, > because: I'm still wondering why the docs bits can't be, at a minimum, "front-ended" by the ports collection in a new doc category? I can understand why you'd want to keep them in their own CVS repository section (doc/), but it would be cool if you could use ports to build and install (or make packages out of) the various documentation sets, especially now that there's talk of breaking up the handbook. Once that happened, you'd automagically appear in the INDEX and under your own category. No work would need to be done to sysinstall. My life would be easier. :) > 2. We need to find a UI model that allows the user to efficiently > select the language and formats they want to install. This wouldn't be quite so elegant, but perhaps Satoshi also wouldn't object to giving you more than one category under ports, just as the German, Japanese, Korean, etc. ports have done. It's either that or accelerate his efforts to go to a multi-layered ports collection so you could have sub-categories. That would lead to menu items like doc-english, doc-vietnamese, doc-french, etc. > I'm thinking of initially presenting a dialog box that looks > like this: I'm certain that once you start writing code for libdialog, my suggestions above will start sounding a lot less icky than they probably do to you right now. :-) - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 9:42:21 2000 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.osd.bsdi.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 2747A37BDB8; Mon, 26 Jun 2000 09:42:19 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.osd.bsdi.com (8.9.3/8.9.3) with ESMTP id JAA02936; Mon, 26 Jun 2000 09:42:57 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) To: Murray Stokely <murray@osd.bsdi.com> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary In-reply-to: Your message of "Mon, 26 Jun 2000 02:34:38 PDT." <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com> Date: Mon, 26 Jun 2000 09:42:57 -0700 Message-ID: <2933.962037777@localhost> From: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > Just as a heads up for everyone I'm going to be coordinating the > work in this area with 3 part-time interns we've hired for the summer. > Hopefully we should see some results by the end of this week. (I'll > bounce the first couple of changes through Nik and Jim) I think you should definitely put Nik's web wishlist very high on the list since, as worthy as all of his other lengthy TODO list items have looked (boy, did Nik return home with a major shot of energy or what? :-), I think a web-makeover would give us the biggest bang-for-buck in terms of user perception. Well, that and breaking the handbook into far more readable sections. :) I also think that the interns will be able to grapple with the web site far more easily than they will be able to come up to speed with DocBook, not that this shouldn't be encouraged. - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 9:43: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 14D7A37BA24; Mon, 26 Jun 2000 09:43:00 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id KAA68852; Mon, 26 Jun 2000 10:42:22 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id KAA19663; Mon, 26 Jun 2000 10:40:34 -0600 (MDT) Message-Id: <200006261640.KAA19663@harmony.village.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Subject: Re: The website Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com In-reply-to: Your message of "Mon, 26 Jun 2000 12:52:43 +0200." <17146.962016763@critter.freebsd.dk> References: <17146.962016763@critter.freebsd.dk> Date: Mon, 26 Jun 2000 10:40:34 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <17146.962016763@critter.freebsd.dk> Poul-Henning Kamp writes: : * Other topic for dynamic content: supported hardware. There is a crying need for this in the pccard world where all of the cards out there are F'd up in some way. The nomad mailing list is talking about how to do this effectively. I think it is a cool idea. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 10: 1:40 2000 Delivered-To: freebsd-doc@freebsd.org Received: from relay1.inwind.it (relay1.inwind.it [212.141.53.67]) by hub.freebsd.org (Postfix) with ESMTP id 967D137BAB3 for <freebsd-doc@FreeBSD.ORG>; Mon, 26 Jun 2000 10:01:37 -0700 (PDT) (envelope-from bartequi@inwind.it) Received: from bartequi.ottodomain.org (212.141.78.117) by relay1.inwind.it; 26 Jun 2000 19:01:34 +0200 From: Salvo Bartolotta <bartequi@inwind.it> Date: Mon, 26 Jun 2000 18:03:34 GMT Message-ID: <20000626.18033400@bartequi.ottodomain.org> Subject: Re: the word demon II (the revenge :-) To: gsutter@zer0.org, jkh@zippy.osd.bsdi.com, err@intergrafix.net Cc: freebsd-doc@FreeBSD.ORG X-Mailer: SuperCalifragilis X-Priority: 3 (Normal) MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Dear Gregory Sutter, thank you for writing. I had read something in Grog's guide (The complete FreeBSD) before; but I was glad to visit the page you kindly provided. Also, you made me recall another etymological, albeit secondary, point: "daimon", in (ancient) Greek, is not a semantically "marked" term; rather, it is employed as a vox media. AFAIR, the "dark" shades of meaning appear in the New Testament. A vox media is a word having no (positive||negative) connotations *per se*: the (classical) Greek term "pharmakon" (medicine, or poison, depending on the context) and the Latin "fortuna" (chance, luck; the English term "fortune" comes from there) are such words. As regards "fortuna", the positive sense is more used today in contemporary English (cf the Italian "fortuna"; the French "fortune" is slightly closer to a vox media; cf the German "Fortuna", "Fortune"). As far as the Greek term "daimon" is concerned, the root "daiomai" {~ "I give, assign [as someone's good||bad luck/destiny)]}", with which it is closely interconnected, is a vox media itself; specifically, it is related to the concept of chance, luck. As a result, "daimon" originally indicated a "god" (ie "being who has the power to give ..."); subsequently (after Homer), its significance became "being intermediate between gods and men", etc. Finally, in the New Testament, the word developed the typical unhappy/evil connotations, which are (more or less) found in modern European languages -- including Italian. On a related note, the Greek word "eudaimonia" ("eu" ~ "good/well" and "daimon"; cf "eudaemonic", "eudaemonism") springs to mind. It has an ample semantic spectrum, hinging on "good luck", and expressing, inter alia, the idea of "welfare, happiness". Incidentally, in German, "Daemon" (actually written with umlaut) is virtually equivalent to "daemon" ("being intermediate between gods and men"; "inner inspiring force"); in French, "d=E9mon" is mostly used in a= religiously/morally (also figuratively) marked sense (~ devil); in Italian, "demone" covers the areas of the German "daemon", as well as those of the English terms "devil" and "daemon" (~ background process in C.S.). Not to mention other Italian correlated/associated words, "demonio" (~ devil; negative also in figurative senses) and "diavolo" (~ devil; not surprisingly, both "diavolo and "devil" derive from Greek "dia+ballo"; cf syn+ballo --> symbol). Best regards, Salvo To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 10:29:10 2000 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 C820A37B70C; Mon, 26 Jun 2000 10:29:07 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 49D1E1C6A; Mon, 26 Jun 2000 13:29:06 -0400 (EDT) Date: Mon, 26 Jun 2000 13:29:06 -0400 From: Bill Fumerola <billf@chc-chimes.com> To: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Cc: Murray Stokely <murray@osd.bsdi.com>, Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary Message-ID: <20000626132906.D5255@jade.chc-chimes.com> References: <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com> <2933.962037777@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <2933.962037777@localhost>; from jkh@zippy.osd.bsdi.com on Mon, Jun 26, 2000 at 09:42:57AM -0700 X-Operating-System: FreeBSD 3.3-STABLE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 09:42:57AM -0700, Jordan K. Hubbard wrote: > I think you should definitely put Nik's web wishlist very high on the > list since, as worthy as all of his other lengthy TODO list items have > looked (boy, did Nik return home with a major shot of energy or what? :-), > I think a web-makeover would give us the biggest bang-for-buck in > terms of user perception. Well, that and breaking the handbook > into far more readable sections. :) I also think that the interns > will be able to grapple with the web site far more easily than they > will be able to come up to speed with DocBook, not that this shouldn't > be encouraged. I think it was the jetski induced adrenialine rush Nik had early Saturday morning. :-> -- Bill Fumerola - Network Architect / Computer Horizons Corp - CVM e-mail: billf@chc-chimes.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 Mon Jun 26 10:31:11 2000 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 2EE0137B51B; Mon, 26 Jun 2000 10:31:08 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: by jade.chc-chimes.com (Postfix, from userid 1001) id 1C0FB1C6A; Mon, 26 Jun 2000 13:31:05 -0400 (EDT) Date: Mon, 26 Jun 2000 13:31:05 -0400 From: Bill Fumerola <billf@chc-chimes.com> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000626133105.E5255@jade.chc-chimes.com> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <17146.962016763@critter.freebsd.dk>; from phk@critter.freebsd.dk on Mon, Jun 26, 2000 at 12:52:43PM +0200 X-Operating-System: FreeBSD 3.3-STABLE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 12:52:43PM +0200, Poul-Henning Kamp wrote: > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. Bill Fenner had something that did this in his bag of tricks, I'm almost positive. -- Bill Fumerola - Network Architect / Computer Horizons Corp - CVM e-mail: billf@chc-chimes.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 Mon Jun 26 10:34: 6 2000 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 B8C8A37B899; Mon, 26 Jun 2000 10:34:04 -0700 (PDT) (envelope-from jkh@FreeBSD.org) Received: (from jkh@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA77029; Mon, 26 Jun 2000 10:34:04 -0700 (PDT) (envelope-from jkh@FreeBSD.org) Date: Mon, 26 Jun 2000 10:34:04 -0700 (PDT) From: <jkh@FreeBSD.org> Message-Id: <200006261734.KAA77029@freefall.freebsd.org> To: si006@ccm.gs.niigata-u.ac.jp, jkh@FreeBSD.org, freebsd-doc@freebsd.org Subject: Re: docs/19520: typo in a release note Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: typo in a release note State-Changed-From-To: open->closed State-Changed-By: jkh State-Changed-When: Mon Jun 26 10:33:57 PDT 2000 State-Changed-Why: Committed, thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=19520 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 10:49:16 2000 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 E071037BC3E; Mon, 26 Jun 2000 10:49: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 SAA68349; Mon, 26 Jun 2000 18:42:50 +0100 (BST) (envelope-from nik) Date: Mon, 26 Jun 2000 18:42:49 +0100 From: Nik Clayton <nik@freebsd.org> To: "Daniel C. Sobral" <dcs@newsguy.com> Cc: Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000626184249.D462@catkin.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <3957413B.83D5DEA4@newsguy.com>; from dcs@newsguy.com on Mon, Jun 26, 2000 at 08:40:44PM +0900 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 08:40:44PM +0900, Daniel C. Sobral wrote: > Jun Kuriyama wrote: > > > And we should keep that master text simple to ease modification by > > hackers. If we force to write complex markups, hackers will *forget* > > to update that master text. :-) > > I'm not sure I would *forget* it, but I my indulge in "forget"ing it. > :-) Typical, I've found the files I was looking for after I make the post. In my world, this XML file would be a replacement for many of the files in src/sys/conf/. Or, at the very least, those files would be generated from this XML file. As a developer, if you don't update the file the system won't even know about your driver (or option). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 10:49:45 2000 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 D072037B70C; Mon, 26 Jun 2000 10:49: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 SAA68048; Mon, 26 Jun 2000 18:40:26 +0100 (BST) (envelope-from nik) Date: Mon, 26 Jun 2000 18:40:25 +0100 From: Nik Clayton <nik@freebsd.org> To: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Cc: Murray Stokely <murray@osd.bsdi.com>, Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary Message-ID: <20000626184024.C462@catkin.nothing-going-on.org> References: <Pine.BSF.4.21.0006260223070.98519-100000@pike.osd.bsdi.com> <2933.962037777@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <2933.962037777@localhost>; from jkh@zippy.osd.bsdi.com on Mon, Jun 26, 2000 at 09:42:57AM -0700 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 09:42:57AM -0700, Jordan K. Hubbard wrote: > > Just as a heads up for everyone I'm going to be coordinating the > > work in this area with 3 part-time interns we've hired for the summer. > > Hopefully we should see some results by the end of this week. (I'll > > bounce the first couple of changes through Nik and Jim) > > I think you should definitely put Nik's web wishlist very high on the > list since, as worthy as all of his other lengthy TODO list items have > looked (boy, did Nik return home with a major shot of energy or what? :-), Just so we're all clear on this -- I haven't got the time or resources to work on all these things at once. Or, indeed, one of them at once. The reason I've written them up is so that interested members of -doc (or the other lists they were cc'd to) get an idea of the TODO list, and can see areas where they can contribute (or lead). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 11: 0:18 2000 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 5542D37B96C for <freebsd-doc@freebsd.org>; Mon, 26 Jun 2000 11:00:11 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA80951 for freebsd-doc@freebsd.org; Mon, 26 Jun 2000 11:00:10 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 26 Jun 2000 11:00:10 -0700 (PDT) Message-Id: <200006261800.LAA80951@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f From: FreeBSD bugmaster <bugmaster@freebsd.org> To: FreeBSD doc list <freebsd-doc@freebsd.org> 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 Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [1999/04/07] docs/10997 doc Problem with query-pr-summary.cgi o [1999/09/25] docs/13950 doc webpage idea o [1999/09/25] docs/13967 doc FreeBSD Related Publications in Korea o [1999/10/06] docs/14158 doc md5(1) manpage should not claim the md5 a o [1999/10/27] docs/14565 doc ioctl() codes for device type `fd' (flopp o [1999/11/03] docs/14682 doc lprm(1) unaware of lp(1) Environment Vari o [1999/12/10] docs/15408 doc Description of ls and nlist wrong in man o [2000/02/23] docs/16934 doc anon transfer log doesn't log all xfers o [2000/03/18] docs/17470 doc Missing man page: pthread_yield f [2000/03/20] docs/17521 doc Proposed FAQ on assembly programming o [2000/03/25] docs/17598 doc installworld over NFS documentation no lo o [2000/04/10] docs/17916 doc [PATCH] rewrite of cutting-edge section o o [2000/04/26] docs/18243 doc wrong description of -p option in sh(1) m o [2000/05/03] docs/18379 doc Information on SSH hard to find in Handbo o [2000/05/12] docs/18520 doc kbdcontrol manpage incomplete o [2000/05/16] docs/18592 doc amd(8) man page missing a line from SYNOP o [2000/05/16] docs/18593 doc VOP_LOOKUP is not a 'VFS entry point' o [2000/05/19] docs/18674 doc ntptime.htm and ntptime.8 o [2000/05/19] docs/18679 doc Subject-Verb agreement in http://docs.Fre f [2000/05/21] docs/18709 doc getch ncurses man page confuses noecho an o [2000/05/24] docs/18792 doc date man page has misleading description o [2000/05/25] docs/18807 doc No documentation for source upgrades o [2000/05/29] docs/18880 doc date.1: merge in OpenBSD enhancements o [2000/06/05] docs/19010 doc Bad144 obsoletion by 4.0 is undocumented; o [2000/06/09] docs/19163 doc stf manual and kernel mismatch o [2000/06/14] docs/19262 doc Is fsync.2 NAME section wrong? o [2000/06/14] docs/19263 doc Please update vfork.2 o [2000/06/15] docs/19300 doc doc/ru_RU.KOI8-R/share/sgml/bookinfo.ent o [2000/06/20] docs/19401 doc Change attribution of the 'yes command' o [2000/06/21] docs/19411 doc [patch] Minor typo in jail.8 o [2000/06/22] docs/19438 doc clarification of umount -t option o [2000/06/23] docs/19481 doc Serial Communications chapter in Handbook o [2000/06/25] docs/19507 doc Mailing-list search at www.freebsd.org re 33 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 Jun 26 11:30: 5 2000 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 1B8AF37BB74 for <freebsd-doc@freebsd.org>; Mon, 26 Jun 2000 11:30:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA87413; Mon, 26 Jun 2000 11:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Mon, 26 Jun 2000 11:30:02 -0700 (PDT) Message-Id: <200006261830.LAA87413@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Rasmus Kaj <kaj@raditex.se> Subject: Re: docs/18792: date man page has misleading description of -r option Reply-To: Rasmus Kaj <kaj@raditex.se> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/18792; it has been noted by GNATS. From: Rasmus Kaj <kaj@raditex.se> To: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net Cc: Rasmus Kaj <kaj@raditex.se> Subject: Re: docs/18792: date man page has misleading description of -r option Date: 26 Jun 2000 20:28:52 +0200 I agree, so heres a diff for /usr/src/bin/date/date.1, in case someone with a commit bit also agrees: -- start of diff -- --- date.1.orig Mon Jun 26 20:25:02 2000 +++ date.1 Mon Jun 26 20:23:17 2000 @@ -92,9 +92,9 @@ .Nm from setting the time for other than the current machine. .It Fl r -Print out the date and time in +Print out the date and time that is .Ar seconds -from the Epoch. +seconds from the Epoch. .It Fl t Set the kernel's value for minutes west of .Tn GMT . -- end of diff -- -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ Machines should work. People should think. -IBM \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 14: 4:30 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id A9C0337BD0F; Mon, 26 Jun 2000 14:04:21 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id PAA70359; Mon, 26 Jun 2000 15:03:57 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id PAA27601; Mon, 26 Jun 2000 15:02:07 -0600 (MDT) Message-Id: <200006262102.PAA27601@harmony.village.org> To: Nik Clayton <nik@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com In-reply-to: Your message of "Sun, 25 Jun 2000 19:58:03 -0000." <20000625195803.G470@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> Date: Mon, 26 Jun 2000 15:02:07 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000625195803.G470@kilt.nothing-going-on.org> Nik Clayton writes: : Another script would parse the above and generate HARDWARE.TXT. And another : could parse the above and spit out DocBook for the Handbook and FAQ. There's some problems witht his. the ed driver supports a whole raft of cards, but who can list them all? Other than that, I like the idea. There's a real, pressing need to know if pccard FOO-bar is supported or is known to work or not in the current version. The PAO folks did a great job with this in their lists of cards known to work. Figuring out how to setup a database with all of this information is going to be tricky. The Japanese nomads were talking about this at one point, and if they come up with someting for pccard, it could likely be extended to all types of cards. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 14: 8:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id B020937B5E8; Mon, 26 Jun 2000 14:08:50 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id PAA70395; Mon, 26 Jun 2000 15:08:46 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id PAA27655; Mon, 26 Jun 2000 15:06:57 -0600 (MDT) Message-Id: <200006262106.PAA27655@harmony.village.org> To: Nik Clayton <nik@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: "Daniel C. Sobral" <dcs@newsguy.com>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Mon, 26 Jun 2000 18:42:49 BST." <20000626184249.D462@catkin.nothing-going-on.org> References: <20000626184249.D462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> Date: Mon, 26 Jun 2000 15:06:57 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000626184249.D462@catkin.nothing-going-on.org> Nik Clayton writes: : In my world, this XML file would be a replacement for many of the files : in src/sys/conf/. Or, at the very least, those files would be generated : from this XML file. As a developer, if you don't update the file the : system won't even know about your driver (or option). I'm not sure how well this would work. Modules already obviate the need to update stuff in sys/conf. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 14:20:14 2000 Delivered-To: freebsd-doc@freebsd.org Received: from funkthat.com (adsl-63-195-54-213.dsl.snfc21.pacbell.net [63.195.54.213]) by hub.freebsd.org (Postfix) with ESMTP id 5F4E337B922; Mon, 26 Jun 2000 14:20:06 -0700 (PDT) (envelope-from gurney_j@efn.org) Received: (from jmg@localhost) by funkthat.com (8.9.3/8.8.7) id OAA53467; Mon, 26 Jun 2000 14:18:32 -0700 (PDT) Message-ID: <20000626141832.11347@hydrogen.funkthat.com> Date: Mon, 26 Jun 2000 14:18:32 -0700 From: John-Mark Gurney <gurney_j@efn.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org Subject: Re: The website References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.69 In-Reply-To: <17146.962016763@critter.freebsd.dk>; from Poul-Henning Kamp on Mon, Jun 26, 2000 at 12:52:43PM +0200 Reply-To: John-Mark Gurney <gurney_j@resnet.uoregon.edu> Organization: Cu Networking X-Operating-System: FreeBSD 3.4-RELEASE i386 X-PGP-Fingerprint: B7 EC EF F8 AE ED A7 31 96 7A 22 B3 D8 56 36 F4 X-Files: The truth is out there X-URL: http://resnet.uoregon.edu/~gurney_j/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Poul-Henning Kamp scribbled this message on Jun 26: > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. this shouldn't be to hard to do, just search through CVSROOT/commitlogs w/ a PDT adjusted time by committer, and then look at the end for a list of files that were included in that commit... I'm not a perl person, so hacking it would be difficult for me... -- John-Mark Gurney Voice: +1 408 975 9651 Cu Networking "Thank God I'm an atheist, that'd just be confusing." -- cmc To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 14:20:16 2000 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 4614E37B7B4 for <freebsd-doc@freebsd.org>; Mon, 26 Jun 2000 14:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id OAA13660; Mon, 26 Jun 2000 14:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from dannyboy.eyep.net (adsl-207-68-84-132.bellatlantic.net [207.68.84.132]) by hub.freebsd.org (Postfix) with ESMTP id 942EC37B7B4 for <FreeBSD-gnats-submit@freebsd.org>; Mon, 26 Jun 2000 14:12:25 -0700 (PDT) (envelope-from dannyboy@dannyboy.eyep.net) Received: (from dannyboy@localhost) by dannyboy.eyep.net (8.9.3/8.9.3) id QAA02804; Mon, 26 Jun 2000 16:49:26 -0400 (EDT) (envelope-from dannyboy) Message-Id: <200006262049.QAA02804@dannyboy.eyep.net> Date: Mon, 26 Jun 2000 16:49:26 -0400 (EDT) From: dannyboy@subdimension.com Reply-To: dannyboy@subdimension.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19534: Nits in new-users Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19534 >Category: docs >Synopsis: Nits in new-users >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 Jun 26 14:20:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Daniel Harris >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: >Description: Missing spaces, closed a parens set, other small nits. >How-To-Repeat: <Coe/input/activities to reproduce the problem (multiple lines)> >Fix: --- /usr/doc/en_US.ISO_8859-1/articles/new-users/article.sgml Tue Oct 12 08:41:51 1999 +++ article.sgml Mon Jun 26 16:25:08 2000 @@ -56,7 +56,7 @@ case-sensitive—<command>exit</command>, not <command>EXIT</command>.</para> - <para>To shut down the machine type:</para> + <para>To shut down the machine type</para> <informalexample> <screen>&prompt.root; <userinput>/sbin/shutdown -h now</userinput> @@ -80,7 +80,7 @@ <para>You can also reboot with <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Delete</keycap></keycombo>. Give it a little time to do its work. This is equivalent to - <command>/sbin/reboot</command> in recent releases of FreeBSD, + <command>/sbin/reboot</command> in recent releases of FreeBSD and is much, much better than hitting the reset button. You don't want to have to reinstall this thing, do you?</para> </sect1> @@ -205,7 +205,7 @@ <listitem> <para>Lists hidden <quote>dot</quote> files with the others. - If you're root, the<quote>dot</quote> files show up + If you're root, the <quote>dot</quote> files show up without the <option>-a</option> switch.</para> </listitem> </varlistentry> @@ -233,7 +233,7 @@ <listitem> <para>Lets you look at a file (named - <replaceable>filename</replaceable> without changing it. + <replaceable>filename</replaceable>) without changing it. Try <command>view <parameter>/etc/fstab</parameter></command>. <command>:q</command> to quit.</para> @@ -374,16 +374,16 @@ time to finish before you start the next one, for now.</para> <informalexample> - <screen>&prompt.root; <userinput>/etc/daily</userinput> + <screen>&prompt.root; <userinput>periodic daily</userinput> <lineannotation>output omitted</lineannotation> -&prompt.root; <userinput>/etc/weekly</userinput> +&prompt.root; <userinput>periodic weekly</userinput> <lineannotation>output omitted</lineannotation> -&prompt.root; <userinput>/etc/monthly</userinput> +&prompt.root; <userinput>periodic monthly</userinput> <lineannotation>output omitted</lineannotation> </screen> </informalexample> - <para>If you get tired waiting, press + <para>If you get tired of waiting, press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> to get another <firstterm>virtual console</firstterm>, and log in again. After all, it's a multi-user, multi-tasking system. @@ -394,7 +394,7 @@ <filename>/var/mail/root</filename> and <filename>/var/log/messages</filename>.</para> - <para>Basically running such commands is part of system + <para>Running such commands is part of system administration—and as a single user of a Unix system, you're your own system administrator. Virtually everything you need to be root to do is system administration. Such @@ -912,10 +912,10 @@ <para>If you originally got Netscape as a port using the CDROM (or ftp), don't replace <filename>/usr/local/bin/netscape</filename> with the new netscape binary; this is just a shell script that - sets up the environmental variables for you. Instead rename the + sets up the environment variables for you. Instead, rename the new binary to <filename>netscape.bin</filename> and replace the old binary, which is - <filename>/usr/local/lib/netscape/netscape.bin</filename>.</para> + <filename>/usr/local/netscape/netscape</filename>.</para> </sect1> <sect1> >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 Jun 26 15:11:14 2000 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 B9FD237B6F9; Mon, 26 Jun 2000 15:10: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 XAA01077; Mon, 26 Jun 2000 23:08:25 +0100 (BST) (envelope-from nik) Date: Mon, 26 Jun 2000 23:08:24 +0100 From: Nik Clayton <nik@freebsd.org> To: Jun Kuriyama <kuriyama@FreeBSD.org> Cc: doc@FreeBSD.org, committers@FreeBSD.org Subject: Re: The website Message-ID: <20000626230824.A388@catkin.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp>; from kuriyama@FreeBSD.org on Mon, Jun 26, 2000 at 07:49:48PM +0900 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 07:49:48PM +0900, Jun Kuriyama wrote: > At 26 Jun 2000 09:33:42 GMT, > nik wrote: > > This also means that a huge reliance on CGI scripts is also a bad > > thing. At the moment mirrors can participate by setting up a fairly > > simple webserver that just has to serve static content. The few CGIs > > that we do have all refer back to the main site. If we were to force > > the mirrors to run the CGI scripts we put a bigger burden on them, both > > in terms of the computing power required to run the scripts, and also > > because they will probably (quite reasonably) want to audit them before > > they run them on their own systems. > > I think so. We should reduce unneeded CGI scripts but this check > should be done carefully. I think current CGI set in www.FreeBSD.org > is quite minimal and difficult to replace with static contents. I'd > like to see a list of what part of CGI should be replaced. Yes. My point was that we shouldn't be introducing new CGI scripts wherever practical. > I don't know about the machine load of web building, but it is > difficult to build web stuff more frequently? Japanese web server > re-builds contents once per an hour, and this helps visitors to see > latest news. (like announcements, ftp/cvsup/www site trouble, seminor > informations, etc.) We could certainly go to a more frequent build -- at the moment, the site doesn't change often enough to make it worthwhile. :-( > > * We should be reusing the orange left hand bar across all the pages. > > It's an accepted design standard on many websites, and there's no > > reason to be gratuitously different from the crowd unless you're trying > > to win design awards. > > > > If you take a look at http://www.demon.net/ you'll see how their left > > side navigation bar expands and contracts as you move through the site, > > showing you where you are in the site, and useful places you can go > > from there. > > > > I like this. It's also not too programmatically difficult to do using > > our SGML tools. > > I'm not expert on web design, but this should be reviewed widely > before replacing. While I'm not an expert on web design, I did spend three years working as the webmaster for a large UK web design firm. Some of it rubs off :-) > > * We might want to give each mailing list its own home page. I knocked > > up a rough prototype of this a while back, which you can find at > > http://people.freebsd.org/~nik/lists/. It needs work (in particular, > > it needs integrating in to a complete site plan, rather than the rough > > proof of concept it is now) but it's (IMHO) a good way of organising a > > lot of our content. > > Yeah, there stuff is good candidate to be written in XML as original > source? :-) Yes. When I did the prototype XML wasn't as widespread as it was. Any implementation of the idea should be XML based. > > * Providing a place to showcase a "Project of the week" on the front > > page (or "Project of the day", or whatever). This would link to one > > of the FreeBSD development projects, with a brief description and a > > pointer to the project's home page. > > > > * As above, but for a "Committer of the Week". IMHO, each committer > > could write up a couple of paragraphs about who they are, how they > > got involved in FreeBSD, what they're working on, and so on. > > I think there ideas are difficult to continue in long term. Many > hackers don't like writing there contents. > > > If I had my way, failure to provide this after a reasonable amount of > > time (6 weeks say) would be grounds to get the commit bit removed. > > The individual chunks of the project don't exist in a vacuum, and > > IMHO all committers should be expected to be able to do this, given > > reasonable notice. > > Of course, this is ideal. But should we remove someone's commit privs > who only have time to hack source code, not document? Don't see why not. If a committer can't put together three or four paragraphs about themself, what they're working on in FreeBSD, how they got involved with FreeBSD, and any interesting other bits and pieces, then, given sufficient notice. . . > > * On each build, generate links to BSD stories on Slashdot, DaemonNews, > > BSD Today, the O'Reilly Dev Centre, and others. > > > > Yes, it's the "P" word -- we should be a BSD Portal. > > Hmmm, it is good idea but it can be done automatically? That's the purpose of this thread. I want to kick-start some prototype implementations. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Jun 26 19:49:26 2000 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 1898237BDDB; Mon, 26 Jun 2000 19:49:25 -0700 (PDT) (envelope-from kevlo@FreeBSD.org) Received: (from kevlo@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA58796; Mon, 26 Jun 2000 19:49:24 -0700 (PDT) (envelope-from kevlo@FreeBSD.org) Date: Mon, 26 Jun 2000 19:49:24 -0700 (PDT) From: <kevlo@FreeBSD.org> Message-Id: <200006270249.TAA58796@freefall.freebsd.org> To: dannyboy@subdimension.com, kevlo@FreeBSD.org, freebsd-doc@freebsd.org Subject: Re: docs/19534: Nits in new-users Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Nits in new-users State-Changed-From-To: open->closed State-Changed-By: kevlo State-Changed-When: Mon Jun 26 19:49:02 PDT 2000 State-Changed-Why: Committed, thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=19534 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 1:50:18 2000 Delivered-To: freebsd-doc@freebsd.org Received: from luna.osd.bsdi.com (luna.geekhouse.net [64.81.6.50]) by hub.freebsd.org (Postfix) with ESMTP id C071637BF7B; Tue, 27 Jun 2000 01:50:14 -0700 (PDT) (envelope-from jim@luna.osd.bsdi.com) Received: by luna.osd.bsdi.com (Postfix, from userid 1000) id 4084A3154; Tue, 27 Jun 2000 01:50:13 -0700 (PDT) Date: Tue, 27 Jun 2000 01:50:13 -0700 From: Jim Mock <jim@FreeBSD.org> To: Nik Clayton <nik@FreeBSD.ORG> Cc: doc@FreeBSD.ORG, dgl@bsdi.com, papowell@astart.com, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Splitting the Handbook Message-ID: <20000627015013.D12152@luna.osd.bsdi.com> Reply-To: jim@FreeBSD.org References: <20000625195506.E470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.4i In-Reply-To: <20000625195506.E470@kilt.nothing-going-on.org>; from nik@FreeBSD.ORG on Sun, Jun 25, 2000 at 07:55:06PM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, 25 Jun 2000 at 19:55:06 +0000, Nik Clayton wrote: > This has been on the cards for ages. > > IMHO, the Handbook, as it stands, is unwieldy. It's too big, it > tries to cater to too many audiences (someone installing FreeBSD, > someone using FreeBSD, someone trying to develop with FreeBSD, someone > who wants to hack on FreeBSD), and there's no one person that 'owns' > it. Indeed. > I want to break the Handbook up in to smaller chunks. We're doing > this already -- the recent creation of the Porter's Handbook reflects > this, as does the work that Jeroen's doing on the Developer's > Handbook. > > [ In fact, if rumour is to be believed, Jim Mock spent most of last > night locked in his hotel room putting together a "New Users > Handbook" -- given the amount of alcohol on offer that's > dedication. ] I almost finished it that night too ;-P I've since added the ``Unix Basics'' chapter to it. The HTML output is available at http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ and the source is available at http://soupnazi.org/~jim/FreeBSD/newuser.tgz. Feedback is welcome. > I also think this would make the job of merging in documentation from > other projects (and, in particular, forming a "BSD Documentation > Project") considerably easier. Agreed. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 2:59:42 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rtf.ustu.ru (rtf.ustu.ru [194.226.224.146]) by hub.freebsd.org (Postfix) with ESMTP id 5CE3737BF46 for <freebsd-doc@FreeBSD.org>; Tue, 27 Jun 2000 02:59:32 -0700 (PDT) (envelope-from pesterev@rtf.ustu.ru) Received: from rtf.ustu.ru [194.226.229.160] by rtf.ustu.ru [194.226.224.146] with SMTP (MDaemon.v3.0.4.R) for <freebsd-doc@FreeBSD.org>; Tue, 27 Jun 2000 15:57:24 +0600 Message-ID: <39587AE6.3D1331B1@rtf.ustu.ru> Date: Tue, 27 Jun 2000 15:59:03 +0600 From: Sergey Pesterev <pesterev@rtf.ustu.ru> X-Mailer: Mozilla 4.7 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org Subject: (no subject) Content-Type: text/plain; charset=koi8-r Content-Transfer-Encoding: 7bit X-MDaemon-Deliver-To: freebsd-doc@FreeBSD.org X-Return-Path: pesterev@rtf.ustu.ru X-MDRcpt-To: freebsd-doc@FreeBSD.org X-MDRemoteIP: 194.226.229.160 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 Tue Jun 27 4:43:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from storm.FreeBSD.org.uk (storm.freebsd.org.uk [194.242.139.170]) by hub.freebsd.org (Postfix) with ESMTP id 9B34537B98D; Tue, 27 Jun 2000 04:43:15 -0700 (PDT) (envelope-from brian@Awfulhak.org) Received: from hak.lan.Awfulhak.org (hak.nat.Awfulhak.org [172.31.0.12]) by storm.FreeBSD.org.uk (8.9.3/8.9.3) with ESMTP id MAA54261; Tue, 27 Jun 2000 12:42:19 +0100 (BST) (envelope-from brian@Awfulhak.org) Received: from hak.lan.Awfulhak.org (localhost [127.0.0.1]) by hak.lan.Awfulhak.org (8.9.3/8.9.3) with ESMTP id MAA16147; Tue, 27 Jun 2000 12:41:49 +0100 (BST) (envelope-from brian@Awfulhak.org) Message-Id: <200006271141.MAA16147@hak.lan.Awfulhak.org> X-Mailer: exmh version 2.1.1 10/15/1999 To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, brian@hak.lan.Awfulhak.org Subject: Re: The website In-Reply-To: Message from Poul-Henning Kamp <phk@critter.freebsd.dk> of "Mon, 26 Jun 2000 12:52:43 +0200." <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Tue, 27 Jun 2000 12:41:49 +0100 From: Brian Somers <brian@Awfulhak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. If we listed the associated files in the commit message, this may become possible: X-commit-list: src/etc/defaults/periodic.conf,1.2,1.3 src/etc/periodic/weekly/400.status-pkg,0,1.1 src/share/man/man5/periodic.conf.5,1.2,1.3 > -- > Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 > phk@FreeBSD.ORG | TCP/IP since RFC 956 > FreeBSD coreteam member | BSD since 4.3-tahoe > Never attribute to malice what can adequately be explained by incompetence. -- Brian <brian@Awfulhak.org> <brian@[uk.]FreeBSD.org> <http://www.Awfulhak.org> <brian@[uk.]OpenBSD.org> Don't _EVER_ lose your sense of humour ! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 6:11:40 2000 Delivered-To: freebsd-doc@freebsd.org Received: from maybe.domainregistry.ie (maybe.domainregistry.ie [193.1.142.4]) by hub.freebsd.org (Postfix) with SMTP id D608237BF4F for <doc@freebsd.org>; Tue, 27 Jun 2000 06:11:36 -0700 (PDT) (envelope-from james@domainregistry.ie) Received: (qmail 19194 invoked by uid 1000); 27 Jun 2000 13:11:33 -0000 Date: Tue, 27 Jun 2000 14:11:33 +0100 From: James Raftery <james@domainregistry.ie> To: doc@freebsd.org Subject: Handbook suggestion Message-ID: <20000627141133.B18942@maybe.domainregistry.ie> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, The link to "CVSup mirror sites" at http://www.freebsd.org/handbook/mirrors-cvsup.html#CVSUP-CONFIG-WHERE just links back to http://www.freebsd.org/handbook/mirrors-cvsup.html and you end up jumping up and down the page! I would suggest linking to http://www.freebsd.org/handbook/mirrors-cvsup.html#AEN21583, "CVSup Sites", instead. Thanks, and Regards, james -- James Raftery (JBR54) - Programmer Hostmaster - IE TLD Hostmaster IE Domain Registry - www.domainregistry.ie - (+353 1) 706 2375 "Managing 4000 customer domains with BIND has been a lot like herding cats." - Mike Batchelor, on dns@list.cr.yp.to. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 9:19:42 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sv01.geocities.co.jp (sv01.geocities.co.jp [210.153.89.155]) by hub.freebsd.org (Postfix) with ESMTP id C180937BA7E; Tue, 27 Jun 2000 09:19:28 -0700 (PDT) (envelope-from hrs@geocities.co.jp) Received: from mail.geocities.co.jp (mail.geocities.co.jp [210.153.89.137]) by sv01.geocities.co.jp (8.9.3+3.2W/3.7W) with ESMTP id BAA18512; Wed, 28 Jun 2000 01:19:26 +0900 (JST) Received: from mail.hrs.jp (sutnmax2-ppp33.ed.noda.sut.ac.jp [133.31.173.103]) by mail.geocities.co.jp (1.3G-GeocitiesJ-3.3) with ESMTP id BAA25205; Wed, 28 Jun 2000 01:19:24 +0900 (JST) Message-Id: <200006271619.BAA25205@mail.geocities.co.jp> Received: from localhost (alph.hrs.jp [192.168.0.10]) by mail.hrs.jp (8.9.3/3.7W/DomainMaster) with ESMTP id XAA35233; Tue, 27 Jun 2000 23:49:36 +0900 (JST) (envelope-from hrs@hrs.jp) To: nik@FreeBSD.ORG Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT In-Reply-To: <20000625195803.G470@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> X-Mailer: Mew version 1.94.1 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Tue, 27 Jun 2000 23:49:34 +0900 From: Hiroki Sato <hrs@geocities.co.jp> X-Dispatcher: imput version 990905(IM130) Lines: 48 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik Clayton <nik@FreeBSD.ORG> wrote in <20000625195803.G470@kilt.nothing-going-on.org>: > [ That schema is not set in stone, and certainly requires more work. In > particular, we probably need "lang" and "encoding" options on the > <comment> element, to support comments in more than one language. ] > > LINT would then become a skeletal file for things which don't fit this > sort of pattern, and the full LINT would be generated by a script which > parsed the above and the skeletal file to generate the full LINT. I think it is difficult to maintain the files because few editors can handle various languages/encodings at the same time. So, especially for translators, it is better that the .xml files are separated on a encoding/language basis. However, separated .xml files according to encoding/language like FreeBSD Handbook also cause another problem. If these files are used to create actual configuration files as not only doc or advisory purpose, translated .xml files but are not synchronized with English version can be more harmful. For instance, the out-dated translation couldn't create an appropriate LINT, so non-English readers cannot know modifications in the original file. Thus, configuration items that don't need to translate should be common, and others such as description field that can be translated should be separated, and it is better that latter separated .xml files (i.e. translated one) have a additional marker that indicates whether a file is synch'ed with the original version or not. Nik Clayton <nik@FreeBSD.ORG> wrote in <20000626115008.B462@catkin.nothing-going-on.org>: > The aim is that we have one file that describes the drivers -- this file > will be used by us to keep the documentation up to date, but it will also > be used by the system -- if the driver writer doesn't update this file then > the system won't know about their driver, and won't build it. They'll *have* > to keep it up to date. One file...why? A port in Ports Collection depends on some files not one file, but it works fine. I think we can maintain more easily several small files than big one file. -- | Hiroki Sato/HRS <hrs@geocities.co.jp> | | j7397067@ed.noda.sut.ac.jp(univ) | hrs@jp.FreeBSD.org(FreeBSD doc-jp Project) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 14:22: 8 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail-blue.research.att.com (mail-blue.research.att.com [135.207.30.102]) by hub.freebsd.org (Postfix) with ESMTP id 7E08337B756; Tue, 27 Jun 2000 14:22:04 -0700 (PDT) (envelope-from fenner@research.att.com) Received: from alliance.research.att.com (alliance.research.att.com [135.207.26.26]) by mail-blue.research.att.com (Postfix) with ESMTP id 870414CEA8; Tue, 27 Jun 2000 17:21:56 -0400 (EDT) Received: from windsor.research.att.com (windsor.research.att.com [135.207.26.46]) by alliance.research.att.com (8.8.7/8.8.7) with ESMTP id RAA13047; Tue, 27 Jun 2000 17:21:55 -0400 (EDT) From: Bill Fenner <fenner@research.att.com> Received: (from fenner@localhost) by windsor.research.att.com (8.8.8+Sun/8.8.5) id OAA10742; Tue, 27 Jun 2000 14:21:55 -0700 (PDT) Message-Id: <200006272121.OAA10742@windsor.research.att.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII To: gurney_j@resnet.uoregon.edu Subject: Re: The website Cc: doc@freebsd.org, committers@freebsd.org References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> <20000626141832.11347@hydrogen.funkthat.com> Date: Tue, 27 Jun 2000 14:21:55 -0700 Versions: dmail (solaris) 2.2g/makemail 2.9a Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Poul-Henning Kamp scribbled this message on Jun 26: >> * Other topic for dynamic content: I would like if cvsweb somehow >> could locate all files relevant to a specific commit, I know this >> is somewhat difficult but It would be nice anyway. > >this shouldn't be to hard to do, just search through CVSROOT/commitlogs >w/ a PDT adjusted time by committer, and then look at the end for a list >of files that were included in that commit... http://www.freebsd.org/~fenner/cgi/log-entry.cgi already knows how to parse the body of commit emails, if anyone wants to work on the searching part. Bill To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 14:49: 2 2000 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 D19BF37B53C; Tue, 27 Jun 2000 14:48:53 -0700 (PDT) (envelope-from chris@holly.calldei.com) Received: from holly.calldei.com ([208.191.149.190]) by mta4.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.2000.01.05.12.18.p9) with ESMTP id <0FWU00J0I1HH72@mta4.rcsntx.swbell.net>; Tue, 27 Jun 2000 16:39:19 -0500 (CDT) Received: (from chris@localhost) by holly.calldei.com (8.9.3/8.9.3) id QAA56207; Tue, 27 Jun 2000 16:37:08 -0500 (CDT envelope-from chris) Date: Tue, 27 Jun 2000 16:37:08 -0500 From: Chris Costello <chris@calldei.com> Subject: Re: The website In-reply-to: <200006271141.MAA16147@hak.lan.Awfulhak.org> To: Brian Somers <brian@Awfulhak.org> Cc: Poul-Henning Kamp <phk@critter.freebsd.dk>, Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, committers@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, brian@hak.lan.Awfulhak.org Reply-To: chris@calldei.com Message-id: <20000627163707.F20702@holly.calldei.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.4i References: <phk@critter.freebsd.dk> <200006271141.MAA16147@hak.lan.Awfulhak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tuesday, June 27, 2000, Brian Somers wrote: > > * Other topic for dynamic content: I would like if cvsweb somehow > > could locate all files relevant to a specific commit, I know this > > is somewhat difficult but It would be nice anyway. > > If we listed the associated files in the commit message, this may > become possible: I do not like the idea of associated files going into a commit log, however, a separate listing or a cross-referencing function for cvsweb should be easy to implement. Bill Fenner has already written a cvs commit mail parser, so we know the e-mail messages can be parsed for their version information. -- |Chris Costello <chris@calldei.com> |Avoid GOTOs completely if you can keep the program readable. `------------------------------------------------------------ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 16: 0:50 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mta.imt.net (mta.imt.net [204.212.40.156]) by hub.freebsd.org (Postfix) with ESMTP id DFC1137BEC4 for <freebsd-doc@FreeBSD.org>; Tue, 27 Jun 2000 16:00:47 -0700 (PDT) (envelope-from root@mta.imt.net) Received: from localhost (root@localhost) by mta.imt.net (8.9.3/8.9.3) with ESMTP id RAA01763 for <freebsd-doc@FreeBSD.org>; Tue, 27 Jun 2000 17:00:11 -0600 Date: Tue, 27 Jun 2000 17:00:11 -0600 (MDT) From: root <root@mta.imt.net> To: freebsd-doc@FreeBSD.org Subject: Question Message-ID: <Pine.LNX.4.10.10006271654120.1754-100000@mta.imt.net> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Dear FreeBSD, I think I have read nearly all the online docs I can find and have had no luck whatsoever find a list of MODEMS compatible with FreeBSD. I have an old box at me home that I am putting together on freebsd to test the proposal that we run this server on freeBSD, but the problem is that that box needs to run on a MODEM, as opposed to a nic card like here. Do you have such a list on the site you could point me to? Sincerely, Russ Mummey - SysAdmin FUNKLTD.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 16:11:10 2000 Delivered-To: freebsd-doc@freebsd.org Received: from pan.ch.intel.com (pan.ch.intel.com [143.182.246.24]) by hub.freebsd.org (Postfix) with ESMTP id 8AC7E37B5CE for <freebsd-doc@freebsd.org>; Tue, 27 Jun 2000 16:11:06 -0700 (PDT) (envelope-from jreynold@sedona.ch.intel.com) Received: from sedona.intel.com (sedona.ch.intel.com [143.182.218.21]) by pan.ch.intel.com (8.9.1a+p1/8.9.1/d: relay.m4,v 1.30 2000/06/08 18:25:35 dmccart Exp $) with ESMTP id QAA05881; Tue, 27 Jun 2000 16:11:03 -0700 (MST) Received: from hip186.ch.intel.com (hip186.ch.intel.com [143.182.225.68]) by sedona.intel.com (8.9.1a/8.9.1/d: sendmail.cf,v 1.10 2000/02/10 21:38:16 steved Exp $) with ESMTP id QAA23235; Tue, 27 Jun 2000 16:11:03 -0700 (MST) X-Envelope-From: jreynold@sedona.ch.intel.com Received: (from jreynold@localhost) by hip186.ch.intel.com (8.9.1a/8.9.1/d: client.m4,v 1.3 1998/09/29 16:36:11 sedayao Exp sedayao $) id TAA01179; Tue, 27 Jun 2000 19:11:03 -0400 (EDT) X-Authentication-Warning: hip186.ch.intel.com: jreynold set sender to jreynold@sedona.ch.intel.com using -f From: John Reynolds~ <jreynold@sedona.ch.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14681.13446.945620.565456@hip186.ch.intel.com> Date: Tue, 27 Jun 2000 16:11:02 -0700 (MST) To: root <root@mta.imt.net> Cc: freebsd-doc@freebsd.org Subject: Re: Question In-Reply-To: <Pine.LNX.4.10.10006271654120.1754-100000@mta.imt.net> References: <Pine.LNX.4.10.10006271654120.1754-100000@mta.imt.net> X-Mailer: VM 6.75 under Emacs 20.3.11 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ On Tuesday, June 27, root wrote: ] > Dear FreeBSD, > > I think I have read nearly all the online docs I can find and have had no > luck whatsoever find a list of MODEMS compatible with FreeBSD. I have an > old box at me home that I am putting together on freebsd to test the > proposal that we run this server on freeBSD, but the problem is that that > box needs to run on a MODEM, as opposed to a nic card like here. > Do you have such a list on the site you could point me to? > > Sincerely, > > Russ Mummey - SysAdmin FUNKLTD.com (sending mail as root to these lists is generally frowned upon ... use your user account). [ also, questions like this would be more suited to questions@freebsd.org not this documentation list in the future ] Just about any "good ol' fashioned modem" can be used with FreeBSD. Winmodems are NOT supported--you need to have a modem with real hardware brains that doesn't rely on a windows driver. I've heard of some stuff going on in 4.x-STABLE (or maybe -current??) where people are trying some (experimental) drivers for PCI modems (again, *real* modems, not fake POS WinModems--they are just on a PCI card rather than ISA). I do not think this is "main stream" however. You are better off just getting yourself a nice USR or Zoom ISA modem (or external if you prefer it), slapping that on an unused COMx port and going to town. Keep in mind that the device files you should use for "dial-out" are: /dev/cuaa0-n (where n "usually" is 3 on a typical machine with 4 com ports) Just make sure that you have got good documentation on the modem so you know the INIT string, etc. Use a comm program such as "minicom" from the ports collection to test out the modem before you begin mucking with ppp (just my opinion). -Jr -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= | John Reynolds WCCG, CCE, Higher Levels of Abstraction | | Intel Corporation MS: CH6-210 Phone: 480-554-9092 pgr: 602-868-6512 | | jreynold@sedona.ch.intel.com http://www-aec.ch.intel.com/~jreynold/ | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 16:26:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id 75B6737C368; Tue, 27 Jun 2000 16:26:06 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (genesis.tao.org.uk [194.242.131.254]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id AAA27579; Wed, 28 Jun 2000 00:26:04 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id 38D0B12555; Wed, 28 Jun 2000 00:27:15 +0100 (BST) Date: Wed, 28 Jun 2000 00:27:14 +0100 From: Josef Karthauser <joe@pavilion.net> To: Nik Clayton <nik@FreeBSD.org> Cc: Jun Kuriyama <kuriyama@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org Subject: Re: The website Message-ID: <20000628002714.O35437@pavilion.net> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> <20000626230824.A388@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000626230824.A388@catkin.nothing-going-on.org>; from nik@FreeBSD.org on Mon, Jun 26, 2000 at 11:08:24PM +0100 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 11:08:24PM +0100, Nik Clayton wrote: > On Mon, Jun 26, 2000 at 07:49:48PM +0900, Jun Kuriyama wrote: > > > > I think so. We should reduce unneeded CGI scripts but this check > > should be done carefully. I think current CGI set in www.FreeBSD.org > > is quite minimal and difficult to replace with static contents. I'd > > like to see a list of what part of CGI should be replaced. > > Yes. My point was that we shouldn't be introducing new CGI scripts wherever > practical. > A trick that we use is to make use of server side includes to allow a crude configuration file method. e.g. a config file. /cgihost.config: www.uk.freebsd.org And a file that uses it: /search.shtml Search the repository <a href="<!--#include virtual="/cgihost.config"-->/cgi-bin/search.cgi">here</a> This would allow the web pages to be coded generically but allow each mirror to choose which server carries the cgi-bin. In the default case it may point to www.freebsd.org, but could be local, or on another local server. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 16:29: 0 2000 Delivered-To: freebsd-doc@freebsd.org Received: from u2.netgate.net (u2.netgate.net [204.145.147.8]) by hub.freebsd.org (Postfix) with ESMTP id ADFA637C03F for <freebsd-doc@FreeBSD.ORG>; Tue, 27 Jun 2000 16:28:56 -0700 (PDT) (envelope-from fishy@u2.netgate.net) Received: from localhost (fishy@localhost) by u2.netgate.net (8.8.5/8.8.8-KB.072299) with ESMTP id QAA19571; Tue, 27 Jun 2000 16:28:53 -0700 (PDT) Date: Tue, 27 Jun 2000 16:28:52 -0700 (PDT) From: Nick Sanders <fishy@netgate.net> To: root <root@mta.imt.net> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Question In-Reply-To: <Pine.LNX.4.10.10006271654120.1754-100000@mta.imt.net> Message-ID: <Pine.BSI.4.05L.10006271625590.19452-100000@u2.netgate.net> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I don't have a list handy, but you can be assured that pretty much all non-winmodems will work. If you get an ISA modem, try to get one where you can configure the COM port and IRQ settings via jumpers, that will make your life easier. - Nick On Tue, 27 Jun 2000, root wrote: > Dear FreeBSD, > > I think I have read nearly all the online docs I can find and have had no > luck whatsoever find a list of MODEMS compatible with FreeBSD. I have an > old box at me home that I am putting together on freebsd to test the > proposal that we run this server on freeBSD, but the problem is that that > box needs to run on a MODEM, as opposed to a nic card like here. > Do you have such a list on the site you could point me to? > > Sincerely, > > Russ Mummey - SysAdmin FUNKLTD.com > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" 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 Jun 27 16:31: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id B928137BF32; Tue, 27 Jun 2000 16:30:57 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (genesis.tao.org.uk [194.242.131.254]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id AAA28112; Wed, 28 Jun 2000 00:29:11 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id 43AC712553; Wed, 28 Jun 2000 00:30:34 +0100 (BST) Date: Wed, 28 Jun 2000 00:30:34 +0100 From: Josef Karthauser <joe@pavilion.net> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000628003034.P35437@pavilion.net> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <17146.962016763@critter.freebsd.dk>; from phk@critter.freebsd.dk on Mon, Jun 26, 2000 at 12:52:43PM +0200 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 12:52:43PM +0200, Poul-Henning Kamp wrote: > > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. I've got a prototype for this. I MD5'd each commit message and then indexed each commit by MD5 checksum. It worked wonderfully. I used a MySQL database under the bonnet to store the indexes, but they could be stored in any kind of database. > * Other topic for dynamic content: HTML'ed page with the last 24h > of commit logs, ie: pointers into cvsweb to see the diffs. I'd be interested in writing/maintaining the generators for this. > * Other topic for dynamic content: A place to keep track of patchsets > up for review, test and comment. Ie: submitter provides patch and > comments and a page is created, linked to from the patchindex and > it is added to the "new or updated" patches. submitter can update > patch as it develops. One way would be to define a convention like: > $HOME/review/$patchname/{README,*} This is a brilliant idea. At the moment there isn't an official place within the project for each external patchsets to be advertised. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 16:34:58 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id 58B6737BF32; Tue, 27 Jun 2000 16:34:47 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (genesis.tao.org.uk [194.242.131.254]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id AAA28560; Wed, 28 Jun 2000 00:32:03 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id B1F6E12553; Wed, 28 Jun 2000 00:33:17 +0100 (BST) Date: Wed, 28 Jun 2000 00:33:17 +0100 From: Josef Karthauser <joe@pavilion.net> To: Brian Somers <brian@Awfulhak.org> Cc: Poul-Henning Kamp <phk@critter.freebsd.dk>, Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, brian@hak.lan.Awfulhak.org Subject: Re: The website Message-ID: <20000628003317.Q35437@pavilion.net> References: <phk@critter.freebsd.dk> <200006271141.MAA16147@hak.lan.Awfulhak.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200006271141.MAA16147@hak.lan.Awfulhak.org>; from brian@Awfulhak.org on Tue, Jun 27, 2000 at 12:41:49PM +0100 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Jun 27, 2000 at 12:41:49PM +0100, Brian Somers wrote: > > * Other topic for dynamic content: I would like if cvsweb somehow > > could locate all files relevant to a specific commit, I know this > > is somewhat difficult but It would be nice anyway. > > If we listed the associated files in the commit message, this may > become possible: > > X-commit-list: src/etc/defaults/periodic.conf,1.2,1.3 src/etc/periodic/weekly/400.status-pkg,0,1.1 src/share/man/man5/periodic.conf.5,1.2,1.3 > Certainly a possibility. I'm reengineering the CVSROOT files at the moment and could certainly add something like this. Another thing that I'm adding is the ability to have branch based mailing lists for people who only want to know what's changing in the RELENG_3 or RELENG_4 branches for instance. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 17:22:37 2000 Delivered-To: freebsd-doc@freebsd.org Received: from overcee.netplex.com.au (peter1.corp.yahoo.com [208.48.107.4]) by hub.freebsd.org (Postfix) with ESMTP id 4AD2D37C4CB; Tue, 27 Jun 2000 17:22:18 -0700 (PDT) (envelope-from peter@netplex.com.au) Received: from netplex.com.au (localhost [127.0.0.1]) by overcee.netplex.com.au (Postfix) with ESMTP id 585371CD7; Tue, 27 Jun 2000 17:22:17 -0700 (PDT) (envelope-from peter@netplex.com.au) X-Mailer: exmh version 2.1.1 10/15/1999 To: Josef Karthauser <joe@pavilion.net> Cc: Brian Somers <brian@Awfulhak.org>, Poul-Henning Kamp <phk@critter.freebsd.dk>, Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, brian@hak.lan.Awfulhak.org Subject: Re: The website In-Reply-To: Message from Josef Karthauser <joe@pavilion.net> of "Wed, 28 Jun 2000 00:33:17 BST." <20000628003317.Q35437@pavilion.net> Date: Tue, 27 Jun 2000 17:22:17 -0700 From: Peter Wemm <peter@netplex.com.au> Message-Id: <20000628002217.585371CD7@overcee.netplex.com.au> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Josef Karthauser wrote: > On Tue, Jun 27, 2000 at 12:41:49PM +0100, Brian Somers wrote: > > > * Other topic for dynamic content: I would like if cvsweb somehow > > > could locate all files relevant to a specific commit, I know this > > > is somewhat difficult but It would be nice anyway. > > > > If we listed the associated files in the commit message, this may > > become possible: > > > > X-commit-list: src/etc/defaults/periodic.conf,1.2,1.3 src/etc/periodic/week ly/400.status-pkg,0,1.1 src/share/man/man5/periodic.conf.5,1.2,1.3 > > > > Certainly a possibility. I'm reengineering the CVSROOT files at the moment > and could certainly add something like this. Another thing that I'm adding > is the ability to have branch based mailing lists for people who only want > to know what's changing in the RELENG_3 or RELENG_4 branches for instance. Consider the SMTP line length limit and the fact that this is in the headers. Consider the 500-files-touched-in-one-commit problem and what this would do to the headers... In other words, I do not like this idea very much. > Joe > > > Cheers, -Peter -- Peter Wemm - peter@FreeBSD.org; peter@yahoo-inc.com; peter@netplex.com.au "All of this is for nothing if we don't go to the stars" - JMS/B5 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Jun 27 19:40:16 2000 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 5C00C37B518 for <freebsd-doc@freebsd.org>; Tue, 27 Jun 2000 19:40:13 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id TAA09105; Tue, 27 Jun 2000 19:40:13 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from smtp1.interramp.com (smtp1.interramp.com [38.8.45.2]) by hub.freebsd.org (Postfix) with ESMTP id A1B4F37B54A for <FreeBSD-gnats-submit@freebsd.org>; Tue, 27 Jun 2000 19:35:45 -0700 (PDT) (envelope-from horikawa@psinet.com) Received: from [38.26.157.4] (helo=localhost) by smtp1.interramp.com with esmtp (Exim 1.90 #1) for FreeBSD-gnats-submit@freebsd.org id 1377hW-0006ZO-00; Tue, 27 Jun 2000 22:35:43 -0400 Message-Id: <20000627223324R.horikawa@psinet.com> Date: Tue, 27 Jun 2000 22:33:24 -0400 From: horikawa@psinet.com Reply-To: horikawa@jp.FreeBSD.org To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19554: date.1 has a typo Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19554 >Category: docs >Synopsis: date.1 has a typo >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 Jun 27 19:40:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Kazuo Horikawa >Release: FreeBSD 3.4-RELEASE i386 >Organization: jpman project >Environment: src/bin/date/date.1 revision 1.37 (HEAD) Following revisions have same typo: RELENG_4 revision 1.34.2.2 RELENG_3 revision 1.26.2.6 >Description: I think that specifying -v+3H on October 29 will not reach October 20. So I think that this is a typo. >How-To-Repeat: $ man 1 date >Fix: If "October 29" is correct, "October 20" should be replaced with "October 30", as follows: --- date.1.orig Tue Jun 27 22:08:48 2000 +++ date.1 Tue Jun 27 22:15:33 2000 @@ -186,7 +186,7 @@ Likewise, if the date is October 29, 0:30 and the DST adjustment means that the clock goes back at 02:00 to 01:00, using .Fl v No +3H -will be necessary to reach October 20, 2:30. +will be necessary to reach October 30, 2:30. .Pp When the date is adjusted to a specific value that doesn't actually exist .Pq for example March 26, 1:30 BST 2000 in the Europe/London timezone , >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 Jun 28 0:14:34 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 0240337BEE6; Wed, 28 Jun 2000 00:14:29 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id BAA78356; Wed, 28 Jun 2000 01:14:24 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id BAA03596; Wed, 28 Jun 2000 01:14:22 -0600 (MDT) Message-Id: <200006280714.BAA03596@harmony.village.org> To: Hiroki Sato <hrs@geocities.co.jp> Subject: Re: XML driver config file to replace LINT Cc: nik@FreeBSD.ORG, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Tue, 27 Jun 2000 23:49:34 +0900." <200006271619.BAA25205@mail.geocities.co.jp> References: <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> Date: Wed, 28 Jun 2000 01:14:22 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Any reason that the .c/.h files of the drivers couldn't be used to generate this information? I think it would greatly enhance the ability of the aintainer to update it. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 0:16:23 2000 Delivered-To: freebsd-doc@freebsd.org Received: from MailExt2.MH-Hannover.DE (tyr.mhrz.mh-hannover.de [193.174.104.34]) by hub.freebsd.org (Postfix) with ESMTP id 0A14137B7BB for <doc@freebsd.org>; Wed, 28 Jun 2000 00:16:19 -0700 (PDT) (envelope-from breull.alf@mh-hannover.de) Received: from nanna.mhrz.mh-hannover.de ([193.174.111.2] helo=Mail.MH-Hannover.DE) by MailExt2.MH-Hannover.DE with esmtp (Exim 3.02 #1) id 137C53-00027J-00 for doc@freebsd.org; Wed, 28 Jun 2000 09:16:17 +0200 Received: from [172.20.241.54] (helo=brea5440) by Mail.MH-Hannover.DE with smtp (Exim 3.02 #1) id 137C52-00054Q-00 for doc@FreeBSD.org; Wed, 28 Jun 2000 09:16:16 +0200 Message-ID: <395A25DB.7540@mh-hannover.de> Date: Wed, 28 Jun 2000 09:20:43 -0700 From: Alfred Breull <breull.alf@mh-hannover.de> X-Mailer: Mozilla 3.04 (Win95; I; 16bit) MIME-Version: 1.0 To: doc@FreeBSD.org Subject: small errata Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org There is a small error at http://www.freebsd.org/handbook/install-guide.html#INSTALL-MSDOS Wrong: C:\> xcopy /s e:\bin c:\FreeBSD\bin\ C:\> xcopy /s e:\manpages c:\FreeBSD\manpages\ Correct: C:\> xcopy e:\bin c:\FreeBSD\bin\ /s C:\> xcopy e:\manpages c:\FreeBSD\manpages\ /s MS-DOS requires the options at the end. Alf To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 2:13: 0 2000 Delivered-To: freebsd-doc@freebsd.org Received: from storm.FreeBSD.org.uk (storm.freebsd.org.uk [194.242.139.170]) by hub.freebsd.org (Postfix) with ESMTP id 723F137B915; Wed, 28 Jun 2000 02:12:51 -0700 (PDT) (envelope-from brian@Awfulhak.org) Received: from hak.lan.Awfulhak.org (hak.nat.Awfulhak.org [172.31.0.12]) by storm.FreeBSD.org.uk (8.9.3/8.9.3) with ESMTP id KAA75487; Wed, 28 Jun 2000 10:12:27 +0100 (BST) (envelope-from brian@Awfulhak.org) Received: from hak.lan.Awfulhak.org (brian@localhost [127.0.0.1]) by hak.lan.Awfulhak.org (8.9.3/8.9.3) with ESMTP id JAA01683; Wed, 28 Jun 2000 09:24:12 +0100 (BST) (envelope-from brian@Awfulhak.org) Message-Id: <200006280824.JAA01683@hak.lan.Awfulhak.org> X-Mailer: exmh version 2.1.1 10/15/1999 To: Peter Wemm <peter@netplex.com.au> Cc: Josef Karthauser <joe@pavilion.net>, Brian Somers <brian@Awfulhak.org>, Poul-Henning Kamp <phk@critter.freebsd.dk>, Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com, brian@hak.lan.Awfulhak.org Subject: Re: The website In-Reply-To: Message from Peter Wemm <peter@netplex.com.au> of "Tue, 27 Jun 2000 17:22:17 PDT." <20000628002217.585371CD7@overcee.netplex.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Wed, 28 Jun 2000 09:24:12 +0100 From: Brian Somers <brian@Awfulhak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > Josef Karthauser wrote: > > On Tue, Jun 27, 2000 at 12:41:49PM +0100, Brian Somers wrote: > > > > * Other topic for dynamic content: I would like if cvsweb somehow > > > > could locate all files relevant to a specific commit, I know this > > > > is somewhat difficult but It would be nice anyway. > > > > > > If we listed the associated files in the commit message, this may > > > become possible: > > > > > > X-commit-list: src/etc/defaults/periodic.conf,1.2,1.3 src/etc/periodic/week > ly/400.status-pkg,0,1.1 src/share/man/man5/periodic.conf.5,1.2,1.3 > > > > > > > Certainly a possibility. I'm reengineering the CVSROOT files at the moment > > and could certainly add something like this. Another thing that I'm adding > > is the ability to have branch based mailing lists for people who only want > > to know what's changing in the RELENG_3 or RELENG_4 branches for instance. > > Consider the SMTP line length limit and the fact that this is in the > headers. Consider the 500-files-touched-in-one-commit problem and what > this would do to the headers... > > In other words, I do not like this idea very much. I don't think the increased size is much of an issue in real life - the increased functionality would be worth it. I didn't realise there as an SMTP line length limit... <thinking out loud> How about something like X-commit-list: http://freefall.FreeBSD.org/cgi-bin/commit-list?200006281234 where 1234 is a sequence number generated at commit time and the commit-list script just generates a list of ``name version version'' lines ? The list can be stored in a date-based directory hierarchy (or some sort of db ?) and will almost definitely compress remarkably well. I prefer the idea of carrying this info around in the actual commit message though. If it's not there, then it's going to be in a place that may be purged at a different time from the original message.... This makes me think that perhaps something more extravagant is required and we should log this stuff in CVSROOT/commitlogs or something. </thinking out loud> -- Brian <brian@Awfulhak.org> <brian@[uk.]FreeBSD.org> <http://www.Awfulhak.org> <brian@[uk.]OpenBSD.org> Don't _EVER_ lose your sense of humour ! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 2:21:23 2000 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 EA19B37B88B; Wed, 28 Jun 2000 02:21:21 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Received: (from mpp@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA63566; Wed, 28 Jun 2000 02:21:21 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Date: Wed, 28 Jun 2000 02:21:21 -0700 (PDT) From: <mpp@FreeBSD.org> Message-Id: <200006280921.CAA63566@freefall.freebsd.org> To: horikawa@jp.FreeBSD.org, mpp@FreeBSD.org, freebsd-doc@freebsd.org Subject: Re: docs/19554: date.1 has a typo Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: date.1 has a typo State-Changed-From-To: open->closed State-Changed-By: mpp State-Changed-When: Wed Jun 28 02:20:56 PDT 2000 State-Changed-Why: Fixed in rev 1.39 of date.1. Thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=19554 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 3:56: 1 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ns.hongik.com (ns.hongik.com [210.124.149.130]) by hub.freebsd.org (Postfix) with ESMTP id 71BDA37B677 for <doc@FreeBSD.org>; Wed, 28 Jun 2000 03:55:58 -0700 (PDT) (envelope-from nobreak@hongik.com) Received: from hongik.com (hi-195.hongik.com [210.124.149.195]) by ns.hongik.com (8.10.1/8.10.1) with ESMTP id e5SAvHG14595 for <doc@FreeBSD.org>; Wed, 28 Jun 2000 19:57:18 +0900 (KST) Message-ID: <3959D980.444591D4@hongik.com> Date: Wed, 28 Jun 2000 19:54:56 +0900 From: Seung-young Kim <nobreak@hongik.com> Reply-To: nobreak@hongik.com Organization: Hongik Internet, Inc. X-Mailer: Mozilla 4.6 [en] (WinNT; I) X-Accept-Language: ko,en MIME-Version: 1.0 To: doc@FreeBSD.org Subject: How can I write '@' character in DocBook <screen> entity? Content-Type: text/plain; charset=EUC-KR Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org How can I write '@' character in DocBook <screen> entity? I want below tags to work well... <screen> From: Mail Delivery Subsystem <MAILER-DAEMON@marie.nobreak.com> To: postmaster@marie.nobreak.com </screen> -- Seung-young Kim http://www.hongik.com Enable your web site with Hongik Internet, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 4:27:59 2000 Delivered-To: freebsd-doc@freebsd.org Received: from smtp.pandora.be (hercules.telenet-ops.be [195.130.132.33]) by hub.freebsd.org (Postfix) with SMTP id 882C037B677 for <freebsd-doc@FreeBSD.ORG>; Wed, 28 Jun 2000 04:27:49 -0700 (PDT) (envelope-from luc.roeffart@pandora.be) Received: (qmail 15063 invoked from network); 28 Jun 2000 11:27:47 -0000 Received: from unknown (HELO r6l6z4) ([213.224.16.48]) (envelope-sender <luc.roeffart@pandora.be>) by hercules.telenet-ops.be (qmail-ldap-1.03) with SMTP for <freebsd-doc@FreeBSD.ORG>; 28 Jun 2000 11:27:47 -0000 Message-ID: <000801bfe0f3$3b126800$3010e0d5@pandora.be> From: "Roeffart Luc" <luc.roeffart@pandora.be> To: <freebsd-doc@FreeBSD.ORG> Subject: printers Date: Wed, 28 Jun 2000 13:23:03 +0200 MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_NextPart_000_0005_01BFE103.FD29F4C0" X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2314.1300 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2314.1300 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This is a multi-part message in MIME format. ------=_NextPart_000_0005_01BFE103.FD29F4C0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable hallo, ik heb een printer(LaserJet 4L er steekt papier in maar hij werkt niet=20 wil u me mailen(in het nederlands)op r_marie_france@hotmail.com met vriendelijke groeten ------=_NextPart_000_0005_01BFE103.FD29F4C0 Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML><HEAD> <META content=3D"text/html; charset=3Diso-8859-1" = http-equiv=3DContent-Type> <META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR> <STYLE></STYLE> </HEAD> <BODY bgColor=3D#ffffff> <DIV><FONT face=3DArial size=3D2>    hallo,</FONT></DIV> <DIV><FONT face=3DArial size=3D2>ik heb een printer(LaserJet = 4L</FONT></DIV> <DIV><FONT face=3DArial size=3D2>er steekt papier in maar hij werkt niet = </FONT></DIV> <DIV> </DIV> <DIV> </DIV> <DIV><FONT face=3DArial size=3D2>wil u me mailen(in het nederlands)op <A = href=3D"mailto:r_marie_france@hotmail.com">r_marie_france@hotmail.com</A>= </FONT></DIV> <DIV><FONT face=3DArial size=3D2>met vriendelijke groeten</FONT></DIV> <DIV> </DIV></BODY></HTML> ------=_NextPart_000_0005_01BFE103.FD29F4C0-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 4:34:52 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id 3F3CB37BEAF for <doc@FreeBSD.ORG>; Wed, 28 Jun 2000 04:34:49 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id NAA81293; Wed, 28 Jun 2000 13:34:27 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: nobreak@hongik.com Cc: doc@FreeBSD.ORG Subject: Re: How can I write '@' character in DocBook <screen> entity? References: <3959D980.444591D4@hongik.com> From: Rasmus Kaj <kaj@raditex.se> Cc: Rasmus Kaj <kaj@raditex.se> Organization: Raditex AB - http://Raditex.se/ Date: 28 Jun 2000 13:34:27 +0200 In-Reply-To: Seung-young Kim's message of "Wed, 28 Jun 2000 19:54:56 +0900" Message-ID: <84lmzqox8c.fsf@frodo.sickla.raditex.se> Lines: 20 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "SK" == Seung-young Kim <nobreak@hongik.com> writes: SK> How can I write '@' character in DocBook <screen> entity? SK> I want below tags to work well... SK> <screen> SK> From: Mail Delivery Subsystem <MAILER-DAEMON@marie.nobreak.com> SK> To: postmaster@marie.nobreak.com SK> </screen> The '@' sign should be no problem. But you can't have an '@' sign in the name of an SGML tag. You need to encode '<' and '>' (as "<" and ">"), otherwise what comes inside them (the mail address) is regarded as a tag. -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ Talk sense to a fool and he calls you foolish. -Euripides \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:56: 8 2000 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 1CC1837B87B; Wed, 28 Jun 2000 06:55:55 -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 NAA00463; Wed, 28 Jun 2000 13:27:02 +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 OAA01669; Tue, 27 Jun 2000 14:50:48 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 14:50:48 +0000 From: Nik Clayton <nik@freebsd.org> To: Warner Losh <imp@village.org> Cc: Nik Clayton <nik@FreeBSD.ORG>, "Daniel C. Sobral" <dcs@newsguy.com>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000627145048.L1582@kilt.nothing-going-on.org> References: <20000626184249.D462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> <20000626184249.D462@catkin.nothing-going-on.org> <200006262106.PAA27655@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 03:06:57PM -0600, Warner Losh wrote: > In message <20000626184249.D462@catkin.nothing-going-on.org> Nik Clayton writes: > : In my world, this XML file would be a replacement for many of the files > : in src/sys/conf/. Or, at the very least, those files would be generated > : from this XML file. As a developer, if you don't update the file the > : system won't even know about your driver (or option). > > I'm not sure how well this would work. Modules already obviate the > need to update stuff in sys/conf. S'fine, that's why this was cc'd to -current. I need input from people involved in the future technical direction of FreeBSD. How are we going to enumerate FreeBSD's supported hardware list in 5.x and beyond? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:56: 8 2000 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 9894A37B64A; Wed, 28 Jun 2000 06:55: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 TAA49462; Tue, 27 Jun 2000 19:07:55 +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 JAA00507; Tue, 27 Jun 2000 09:57:06 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 09:57:06 +0000 From: Nik Clayton <nik@freebsd.org> To: Warner Losh <imp@village.org> Cc: Nik Clayton <nik@FreeBSD.ORG>, "Daniel C. Sobral" <dcs@newsguy.com>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000627095706.C316@kilt.nothing-going-on.org> References: <20000626184249.D462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> <20000626184249.D462@catkin.nothing-going-on.org> <200006262106.PAA27655@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200006262106.PAA27655@harmony.village.org>; from imp@village.org on Mon, Jun 26, 2000 at 03:06:57PM -0600 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 03:06:57PM -0600, Warner Losh wrote: > In message <20000626184249.D462@catkin.nothing-going-on.org> Nik Clayton writes: > : In my world, this XML file would be a replacement for many of the files > : in src/sys/conf/. Or, at the very least, those files would be generated > : from this XML file. As a developer, if you don't update the file the > : system won't even know about your driver (or option). > > I'm not sure how well this would work. Modules already obviate the > need to update stuff in sys/conf. S'fine, that's why this was cc'd to -current. I need input from people involved in the future technical direction of FreeBSD. How are we going to enumerate FreeBSD's supported hardware list in 5.x and beyond? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:56:49 2000 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 7687237B84A; Wed, 28 Jun 2000 06:56:41 -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 NAA00461; Wed, 28 Jun 2000 13:26: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 OAA01663; Tue, 27 Jun 2000 14:50:44 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 14:50:44 +0000 From: Nik Clayton <nik@freebsd.org> To: Rasmus Kaj <kaj@Raditex.se> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary Message-ID: <20000627145044.K1582@kilt.nothing-going-on.org> References: <20000625195647.F470@kilt.nothing-going-on.org> <rqcu2egya5z.fsf@alumoklyuchevskit.e.kth.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 01:05:44PM +0200, Rasmus Kaj wrote: > >>>>> "NC" == Nik Clayton <nik@FreeBSD.ORG> writes: > NC> In fact, we can probably take this a step further -- all the > NC> documentation projects are going to need a glossary, and why try and > NC> reinvent the wheel each time? > > NC> Someone (probably us) should start a free glossary project. Each > NC> documentation project can submit definitions to it, and can pick and > NC> choose definitions from other projects as necessary. Anyone want to > NC> pick this idea up and run with it? > > How would this new project differ from FOLDOC [1] (Free OnLine > Dictionary Of Computing) ? Dictionaries aren't quite the same as glossaries, although there are similarities. But. . . > Or might FOLDOC be a good project to join forces with on this? > > [1] http://www.InstantWeb.com/foldoc/foldoc.cgi?FOLDOC . . . they might be. Are you volunteering to contact them and see if they're interested? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:56:58 2000 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 A073237B856; Wed, 28 Jun 2000 06:56:41 -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 TAA49464; Tue, 27 Jun 2000 19:07:55 +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 JAA00497; Tue, 27 Jun 2000 09:55:14 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 09:55:14 +0000 From: Nik Clayton <nik@freebsd.org> To: Rasmus Kaj <kaj@Raditex.se> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Indexing and glossary Message-ID: <20000627095514.B316@kilt.nothing-going-on.org> References: <20000625195647.F470@kilt.nothing-going-on.org> <rqcu2egya5z.fsf@alumoklyuchevskit.e.kth.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <rqcu2egya5z.fsf@alumoklyuchevskit.e.kth.se>; from kaj@Raditex.se on Mon, Jun 26, 2000 at 01:05:44PM +0200 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 01:05:44PM +0200, Rasmus Kaj wrote: > >>>>> "NC" == Nik Clayton <nik@FreeBSD.ORG> writes: > NC> In fact, we can probably take this a step further -- all the > NC> documentation projects are going to need a glossary, and why try and > NC> reinvent the wheel each time? > > NC> Someone (probably us) should start a free glossary project. Each > NC> documentation project can submit definitions to it, and can pick and > NC> choose definitions from other projects as necessary. Anyone want to > NC> pick this idea up and run with it? > > How would this new project differ from FOLDOC [1] (Free OnLine > Dictionary Of Computing) ? Dictionaries aren't quite the same as glossaries, although there are similarities. But. . . > Or might FOLDOC be a good project to join forces with on this? > > [1] http://www.InstantWeb.com/foldoc/foldoc.cgi?FOLDOC . . . they might be. Are you volunteering to contact them and see if they're interested? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:57:48 2000 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 D4E0937B921; Wed, 28 Jun 2000 06:57:30 -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 NAA00465; Wed, 28 Jun 2000 13:27:05 +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 OAA01675; Tue, 27 Jun 2000 14:50:51 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 14:50:51 +0000 From: Nik Clayton <nik@freebsd.org> To: Warner Losh <imp@village.org> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: XML driver config file to replace LINT Message-ID: <20000627145051.M1582@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <200006262102.PAA27601@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 03:02:07PM -0600, Warner Losh wrote: > In message <20000625195803.G470@kilt.nothing-going-on.org> Nik Clayton writes: > : Another script would parse the above and generate HARDWARE.TXT. And another > : could parse the above and spit out DocBook for the Handbook and FAQ. > > There's some problems witht his. the ed driver supports a whole raft > of cards, but who can list them all? Initially, the driver's author. Over time, user submissions will indicate whether a particular driver supports a particular card. All I want to do is make sure that this information only needs to be maintained in one place. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:58: 9 2000 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 212B837B856; Wed, 28 Jun 2000 06:58:00 -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 TAA49466; Tue, 27 Jun 2000 19:07:55 +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 JAA00517; Tue, 27 Jun 2000 09:58:04 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 09:58:03 +0000 From: Nik Clayton <nik@freebsd.org> To: Warner Losh <imp@village.org> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: XML driver config file to replace LINT Message-ID: <20000627095803.D316@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <200006262102.PAA27601@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200006262102.PAA27601@harmony.village.org>; from imp@village.org on Mon, Jun 26, 2000 at 03:02:07PM -0600 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 03:02:07PM -0600, Warner Losh wrote: > In message <20000625195803.G470@kilt.nothing-going-on.org> Nik Clayton writes: > : Another script would parse the above and generate HARDWARE.TXT. And another > : could parse the above and spit out DocBook for the Handbook and FAQ. > > There's some problems witht his. the ed driver supports a whole raft > of cards, but who can list them all? Initially, the driver's author. Over time, user submissions will indicate whether a particular driver supports a particular card. All I want to do is make sure that this information only needs to be maintained in one place. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:58:49 2000 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 F013D37B87E; Wed, 28 Jun 2000 06:58: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 NAA00467; Wed, 28 Jun 2000 13:27:08 +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 OAA01681; Tue, 27 Jun 2000 14:50:54 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 14:50:54 +0000 From: Nik Clayton <nik@freebsd.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000627145054.N1582@kilt.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 12:52:43PM +0200, Poul-Henning Kamp wrote: > Go For It! Thanks. But I stress that I want to see others "going for it" as well. The past few posts from me have outlined what I think needs to be done on the doc. project. This is not the same thing as what I, personally, can accomplish on the doc. project -- certainly not unless someone wants to fund me to do it, and even then I have existing and up-coming commitments that make this sort of tricky. If you (generic "you") have read anything here and think "I could do that" or "I was looking for a way to contribute" or even "I'm a CS student and need to do a project in order to graduate, that looks interesting" then say so. > A few comments: > > * Database driven content is OK, as long as it is not the main page, > currently our cvs-web and search engines work OK in the overall > mirror strategy. Depends. If we rely on database content for the majority of the site then we may as well not bother with mirrors. While this is tempting, I don't think it's going to be possible to put www.freebsd.org anywhere that's sufficiently well connected that the rest of the planet can get to it without worrying about latency or downtime. > * Other topic for dynamic content: supported hardware. Already covered. See my messages to -doc and -current about this. However, while this would be dynamic, it would be generated when the web site is built periodically, rather than on the fly each time. > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. Don't know if CVS can even do this. Joe K had a prototype implementation that does this, but as I recall it needed a backend database and took a few hours to index the source tree. > * Other topic for dynamic content: HTML'ed page with the last 24h > of commit logs, ie: pointers into cvsweb to see the diffs. Code contributions to do this welcome. > * Other topic for dynamic content: A place to keep track of patchsets > up for review, test and comment. Ie: submitter provides patch and > comments and a page is created, linked to from the patchindex and > it is added to the "new or updated" patches. submitter can update > patch as it develops. One way would be to define a convention like: > $HOME/review/$patchname/{README,*} Yep, like it. Anyone want to develop this further? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 6:59:53 2000 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 3A99F37BC01; Wed, 28 Jun 2000 06:59:36 -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 TAA49467; Tue, 27 Jun 2000 19:07:56 +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 KAA00537; Tue, 27 Jun 2000 10:04:16 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 10:04:15 +0000 From: Nik Clayton <nik@freebsd.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000627100415.E316@kilt.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <17146.962016763@critter.freebsd.dk>; from phk@critter.freebsd.dk on Mon, Jun 26, 2000 at 12:52:43PM +0200 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 12:52:43PM +0200, Poul-Henning Kamp wrote: > Go For It! Thanks. But I stress that I want to see others "going for it" as well. The past few posts from me have outlined what I think needs to be done on the doc. project. This is not the same thing as what I, personally, can accomplish on the doc. project -- certainly not unless someone wants to fund me to do it, and even then I have existing and up-coming commitments that make this sort of tricky. If you (generic "you") have read anything here and think "I could do that" or "I was looking for a way to contribute" or even "I'm a CS student and need to do a project in order to graduate, that looks interesting" then say so. > A few comments: > > * Database driven content is OK, as long as it is not the main page, > currently our cvs-web and search engines work OK in the overall > mirror strategy. Depends. If we rely on database content for the majority of the site then we may as well not bother with mirrors. While this is tempting, I don't think it's going to be possible to put www.freebsd.org anywhere that's sufficiently well connected that the rest of the planet can get to it without worrying about latency or downtime. > * Other topic for dynamic content: supported hardware. Already covered. See my messages to -doc and -current about this. However, while this would be dynamic, it would be generated when the web site is built periodically, rather than on the fly each time. > * Other topic for dynamic content: I would like if cvsweb somehow > could locate all files relevant to a specific commit, I know this > is somewhat difficult but It would be nice anyway. Don't know if CVS can even do this. Joe K had a prototype implementation that does this, but as I recall it needed a backend database and took a few hours to index the source tree. > * Other topic for dynamic content: HTML'ed page with the last 24h > of commit logs, ie: pointers into cvsweb to see the diffs. Code contributions to do this welcome. > * Other topic for dynamic content: A place to keep track of patchsets > up for review, test and comment. Ie: submitter provides patch and > comments and a page is created, linked to from the patchindex and > it is added to the "new or updated" patches. submitter can update > patch as it develops. One way would be to define a convention like: > $HOME/review/$patchname/{README,*} Yep, like it. Anyone want to develop this further? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 8:16:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mailout05.sul.t-online.com (mailout05.sul.t-online.com [194.25.134.82]) by hub.freebsd.org (Postfix) with ESMTP id CFC1037B9CA for <freebsd-doc@freebsd.org>; Wed, 28 Jun 2000 08:16:43 -0700 (PDT) (envelope-from Meerwaldt@t-online.de) Received: from fwd06.sul.t-online.com by mailout05.sul.t-online.com with smtp id 137JZy-0003rp-00; Wed, 28 Jun 2000 17:16:42 +0200 Received: from server.wes.mee.com (320044045192-0001@[193.158.179.64]) by fwd06.sul.t-online.com with esmtp id 137JZw-0nEqyAC; Wed, 28 Jun 2000 17:16:40 +0200 Received: from localhost (localhost [127.0.0.1]) by server.wes.mee.com (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id RAA01256; Wed, 28 Jun 2000 17:10:31 +0200 (CEST) Date: Wed, 28 Jun 2000 17:10:31 +0200 (CEST) From: Meerwaldt@t-online.de (Frederik Meerwaldt) Reply-To: fm_sendthere@gmx.de To: root <root@mta.imt.net> Cc: freebsd-doc@freebsd.org Subject: Re: Question In-Reply-To: <Pine.LNX.4.10.10006271654120.1754-100000@mta.imt.net> Message-ID: <Pine.BSF.4.21.0006281709100.1242-100000@server.wes.mee.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Sender: 320044045192-0001@t-dialin.net Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi! > > I think I have read nearly all the online docs I can find and have had no > luck whatsoever find a list of MODEMS compatible with FreeBSD. I have an > old box at me home that I am putting together on freebsd to test the > proposal that we run this server on freeBSD, but the problem is that that > box needs to run on a MODEM, as opposed to a nic card like here. > Do you have such a list on the site you could point me to? If it is an external modem, which is connected to your serial port, every modem should work. Point me to a better direction, but I had success with every modem. If it is an internal modem, much modems are supported. The only ones which aren't are the "Winmodems" Bye, Freddy To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 8:27:41 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ptd.net (mail1.ha-net.ptd.net [207.44.96.65]) by hub.freebsd.org (Postfix) with SMTP id 45CFE37B9EC for <doc@FreeBSD.ORG>; Wed, 28 Jun 2000 08:27:38 -0700 (PDT) (envelope-from tms2@mail.ptd.net) Received: (qmail 581 invoked from network); 28 Jun 2000 15:27:42 -0000 Received: from du213.cli.ptd.net (HELO mail.ptd.net) (204.186.33.213) by mail.ptd.net with SMTP; 28 Jun 2000 15:27:42 -0000 Message-ID: <395A1950.50ECD8D5@mail.ptd.net> Date: Wed, 28 Jun 2000 11:27:12 -0400 From: "Thomas M. Sommers" <tms2@mail.ptd.net> Organization: None X-Mailer: Mozilla 4.72 [en] (X11; I; FreeBSD 4.0-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT References: <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Warner Losh wrote: > > Any reason that the .c/.h files of the drivers couldn't be used to > generate this information? Or perhaps the other way around. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 8:46:25 2000 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 E7FAD37BA9C; Wed, 28 Jun 2000 08:45:58 -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 NAA00459; Wed, 28 Jun 2000 13:26:54 +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 OAA01657; Tue, 27 Jun 2000 14:50:40 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 14:50:40 +0000 From: Nik Clayton <nik@freebsd.org> To: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Cc: Nik Clayton <nik@freebsd.org>, doc@freebsd.org, hackers@freebsd.org, jkh@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Documentation selection in sysinstall Message-ID: <20000627145040.J1582@kilt.nothing-going-on.org> References: <20000625195203.C470@kilt.nothing-going-on.org> <2884.962037460@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 09:37:40AM -0700, Jordan K. Hubbard wrote: > > In theory, this is a doddle. sysinstall already lets the user choose from > > packages to install. In practice, I think it's a little more difficult, > > because: > > I'm still wondering why the docs bits can't be, at a minimum, > "front-ended" by the ports collection in a new doc category? We could do this -- I'd probably use the ports collection to front-end the binary packages. Otherwise, the user might as well just go and CVSup the doc/ collection themselves, and build it that way. > > I'm thinking of initially presenting a dialog box that looks > > like this: > > I'm certain that once you start writing code for libdialog, my > suggestions above will start sounding a lot less icky than they > probably do to you right now. :-) I have no intention of going anywhere near libdialog -- like I say, I can either put forward proposals and ideas, and assist with them, or I can try and do one thing at a time. At the moment, keeping up with the -doc mail is almost a full time job in itself. What happened to the plans to move to the TurboVision library? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 8:47:21 2000 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 CFF2137BDE7; Wed, 28 Jun 2000 08:47:13 -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 TAA49472; Tue, 27 Jun 2000 19:07:56 +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 JAA00484; Tue, 27 Jun 2000 09:53:33 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Tue, 27 Jun 2000 09:53:33 +0000 From: Nik Clayton <nik@freebsd.org> To: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Cc: Nik Clayton <nik@freebsd.org>, doc@freebsd.org, hackers@freebsd.org, jkh@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Documentation selection in sysinstall Message-ID: <20000627095332.A316@kilt.nothing-going-on.org> References: <20000625195203.C470@kilt.nothing-going-on.org> <2884.962037460@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <2884.962037460@localhost>; from jkh@zippy.osd.bsdi.com on Mon, Jun 26, 2000 at 09:37:40AM -0700 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 09:37:40AM -0700, Jordan K. Hubbard wrote: > > In theory, this is a doddle. sysinstall already lets the user choose from > > packages to install. In practice, I think it's a little more difficult, > > because: > > I'm still wondering why the docs bits can't be, at a minimum, > "front-ended" by the ports collection in a new doc category? We could do this -- I'd probably use the ports collection to front-end the binary packages. Otherwise, the user might as well just go and CVSup the doc/ collection themselves, and build it that way. > > I'm thinking of initially presenting a dialog box that looks > > like this: > > I'm certain that once you start writing code for libdialog, my > suggestions above will start sounding a lot less icky than they > probably do to you right now. :-) I have no intention of going anywhere near libdialog -- like I say, I can either put forward proposals and ideas, and assist with them, or I can try and do one thing at a time. At the moment, keeping up with the -doc mail is almost a full time job in itself. What happened to the plans to move to the TurboVision library? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:32:52 2000 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 AEA2637BC58; Wed, 28 Jun 2000 09:32: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 RAA67874; Wed, 28 Jun 2000 17:31:49 +0100 (BST) (envelope-from nik) Date: Wed, 28 Jun 2000 17:31:46 +0100 From: Nik Clayton <nik@freebsd.org> To: Hiroki Sato <hrs@geocities.co.jp> Cc: nik@FreeBSD.ORG, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000628173144.B51610@catkin.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200006271619.BAA25205@mail.geocities.co.jp>; from hrs@geocities.co.jp on Tue, Jun 27, 2000 at 11:49:34PM +0900 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Jun 27, 2000 at 11:49:34PM +0900, Hiroki Sato wrote: > Nik Clayton <nik@FreeBSD.ORG> wrote > in <20000625195803.G470@kilt.nothing-going-on.org>: > > > [ That schema is not set in stone, and certainly requires more work. In > > particular, we probably need "lang" and "encoding" options on the > > <comment> element, to support comments in more than one language. ] > > > > LINT would then become a skeletal file for things which don't fit this > > sort of pattern, and the full LINT would be generated by a script which > > parsed the above and the skeletal file to generate the full LINT. > > I think it is difficult to maintain the files because few editors > can handle various languages/encodings at the same time. > So, especially for translators, it is better that the .xml files > are separated on a encoding/language basis. Possibly. I was thinking that the only thing that would be language specific about each driver would be the comment section. <comment>...</comment> All the other stuff is language independent. That being the case, it wouldn't be too hard to do <commant lang="ja_JP.EUCjp">...</comment> <comment lang="es_ES.ISO_8859-1">...</comment> and so on, would it? Or does loading Japanese text in to a non-Japanese aware editor scramble the text? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:33: 8 2000 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 6BCE437BEFA; Wed, 28 Jun 2000 09:32:55 -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 RAA54817; Wed, 28 Jun 2000 17:23:43 +0100 (BST) (envelope-from nik) Date: Wed, 28 Jun 2000 17:23:41 +0100 From: Nik Clayton <nik@freebsd.org> To: Josef Karthauser <joe@pavilion.net> Cc: Nik Clayton <nik@FreeBSD.org>, Jun Kuriyama <kuriyama@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org Subject: Re: The website Message-ID: <20000628172341.A51610@catkin.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> <20000626230824.A388@catkin.nothing-going-on.org> <20000628002714.O35437@pavilion.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628002714.O35437@pavilion.net>; from joe@pavilion.net on Wed, Jun 28, 2000 at 12:27:14AM +0100 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 12:27:14AM +0100, Josef Karthauser wrote: > A trick that we use is to make use of server side includes to allow > a crude configuration file method. Problem with that is that you then need to be running a webserver before you can effectively test the site -- also, you probably need to be running the same webserver as everyone else (unless SSI is standardised between different servers). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:37:50 2000 Delivered-To: freebsd-doc@freebsd.org Received: from zippy.osd.bsdi.com (zippy.cdrom.com [204.216.27.228]) by hub.freebsd.org (Postfix) with ESMTP id 3D6A137BA31; Wed, 28 Jun 2000 09:37:47 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) Received: from localhost (jkh@localhost [127.0.0.1]) by zippy.osd.bsdi.com (8.9.3/8.9.3) with ESMTP id JAA14313; Wed, 28 Jun 2000 09:38:14 -0700 (PDT) (envelope-from jkh@zippy.osd.bsdi.com) To: Nik Clayton <nik@freebsd.org> Cc: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com>, doc@freebsd.org, hackers@freebsd.org, jkh@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Documentation selection in sysinstall In-reply-to: Your message of "Tue, 27 Jun 2000 14:50:40 -0000." <20000627145040.J1582@kilt.nothing-going-on.org> Date: Wed, 28 Jun 2000 09:38:14 -0700 Message-ID: <14310.962210294@localhost> From: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > What happened to the plans to move to the TurboVision library? We're still working on it. - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:38:10 2000 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 539D037B556; Wed, 28 Jun 2000 09:38: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 RAA72736; Wed, 28 Jun 2000 17:35:02 +0100 (BST) (envelope-from nik) Date: Wed, 28 Jun 2000 17:34:58 +0100 From: Nik Clayton <nik@freebsd.org> To: "Thomas M. Sommers" <tms2@mail.ptd.net> Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000628173457.C51610@catkin.nothing-going-on.org> References: <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <395A1950.50ECD8D5@mail.ptd.net>; from tms2@mail.ptd.net on Wed, Jun 28, 2000 at 11:27:12AM -0400 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 11:27:12AM -0400, Thomas M. Sommers wrote: > Warner Losh wrote: > > > > Any reason that the .c/.h files of the drivers couldn't be used to > > generate this information? > > Or perhaps the other way around. That's what I'd prefer. Any solution that relys on trying to parse "structured comments" like that is a kludge at best. I'd rather get all this information in to a usefully structured form now, and then process it to produce the various output formats we need. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:54: 8 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout2.silyn-tek.de (mout2.silyn-tek.de [194.25.165.70]) by hub.freebsd.org (Postfix) with ESMTP id 2F61B37BC30; Wed, 28 Jun 2000 09:53:52 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.34] (helo=mx2.silyn-tek.de) by mout2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137L4Z-00087Z-00; Wed, 28 Jun 2000 18:52:23 +0200 Received: from p3e9d38b7.dip0.t-ipconnect.de ([62.157.56.183] helo=neutron.cichlids.com) by mx2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137L4Y-0001ZG-00; Wed, 28 Jun 2000 18:52:22 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id C0A62AC27; Wed, 28 Jun 2000 18:52:19 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id E082114B05; Wed, 28 Jun 2000 18:52:12 +0200 (CEST) Date: Wed, 28 Jun 2000 18:52:12 +0200 To: "Jordan K. Hubbard" <jkh@zippy.osd.bsdi.com> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG, hackers@FreeBSD.ORG, jkh@FreeBSD.ORG, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.ORG, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Documentation selection in sysinstall Message-ID: <20000628185212.A58389@cichlids.cichlids.com> References: <20000627145040.J1582@kilt.nothing-going-on.org> <14310.962210294@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <14310.962210294@localhost>; from jkh@zippy.osd.bsdi.com on Wed, Jun 28, 2000 at 09:38:14AM -0700 X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. From: alex@big.endian.de (Alexander Langer) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thus spake Jordan K. Hubbard (jkh@zippy.osd.bsdi.com): > > What happened to the plans to move to the TurboVision library? > We're still working on it. Yes, someone should encourage John Baldwin to fix that. For example by promising some cakes or something :) Alex -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 9:54:34 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id E5EB037C210; Wed, 28 Jun 2000 09:54:23 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (postfix@genius.systems.pavilion.net [212.74.1.100]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id RAA37428; Wed, 28 Jun 2000 17:54:22 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id 7A65311BD7; Wed, 28 Jun 2000 17:55:47 +0100 (BST) Date: Wed, 28 Jun 2000 17:55:47 +0100 From: Josef Karthauser <joe@pavilion.net> To: Nik Clayton <nik@freebsd.org> Cc: Jun Kuriyama <kuriyama@freebsd.org>, doc@freebsd.org, committers@freebsd.org Subject: Re: The website Message-ID: <20000628175547.Z33390@pavilion.net> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> <20000626230824.A388@catkin.nothing-going-on.org> <20000628002714.O35437@pavilion.net> <20000628172341.A51610@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628172341.A51610@catkin.nothing-going-on.org>; from nik@freebsd.org on Wed, Jun 28, 2000 at 05:23:41PM +0100 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 05:23:41PM +0100, Nik Clayton wrote: > On Wed, Jun 28, 2000 at 12:27:14AM +0100, Josef Karthauser wrote: > > A trick that we use is to make use of server side includes to allow > > a crude configuration file method. > > Problem with that is that you then need to be running a webserver before > you can effectively test the site -- also, you probably need to be running > the same webserver as everyone else (unless SSI is standardised between > different servers). Who's not running Apache? :) I believe that SSI is fairly common, although I don't know whether IIS supports it :) Ok - if we don't want to do that then we at least need a way of branding cgi-hosts into the local copy so that each mirror can choose to point the punters to the "local" cgi server. We want to run a cgi server here in the UK, but it makes little sense until we can point all to it by default from the UK web mirrors. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 10:49:53 2000 Delivered-To: freebsd-doc@freebsd.org Received: from spirit.jaded.net (shortbus.jaded.net [216.94.132.8]) by hub.freebsd.org (Postfix) with ESMTP id A8E5F37BF08; Wed, 28 Jun 2000 10:49:40 -0700 (PDT) (envelope-from dan@spirit.jaded.net) Received: (from dan@localhost) by spirit.jaded.net (8.9.3/8.9.3) id NAA00640; Wed, 28 Jun 2000 13:49:36 -0400 (EDT) (envelope-from dan) Date: Wed, 28 Jun 2000 13:49:36 -0400 From: Dan Moschuk <dan@freebsd.org> To: Nik Clayton <nik@freebsd.org> Cc: Jun Kuriyama <kuriyama@freebsd.org>, doc@freebsd.org, current@freebsd.org Subject: Re: XML driver config file to replace LINT Message-ID: <20000628134936.A524@spirit.jaded.net> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <20000626115008.B462@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20000626115008.B462@catkin.nothing-going-on.org>; from nik@freebsd.org on Mon, Jun 26, 2000 at 11:50:09AM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org | I disagree. We're not Linux, where people can throw in code without thought | to the wider consequences -- one of the commitments you should make (that's | a generic "you" there, not you specifically) as a FreeBSD committer is to | maintain the documentation that's affected by your changes. A look at | HARDWARE.TXT shows that (with a few notable exceptions) the FreeBSD Developer | Community at large is *not* keeping it up to date. Perhaps it would be a good idea to assign someone the task of just maintaing the HARDWARE.TXT file, rather than expecting all developers to keep documentation up to date? Warner is the gatekeeper for UPDATING, and it seems to work rather well. If there is no one explicitly on the doc project that you'd like doing this, I'd take on the responsibility. -- Dan Moschuk (TFreak!dan@freebsd.org) "Don't get even -- get odd!" To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 11:21:17 2000 Delivered-To: freebsd-doc@freebsd.org Received: from relay01.chello.nl (smtp.chello.nl [212.83.68.144]) by hub.freebsd.org (Postfix) with ESMTP id 6493D37BB6F; Wed, 28 Jun 2000 11:21:11 -0700 (PDT) (envelope-from wkb@chello.nl) Received: from chello.nl ([213.46.78.184]) by relay01.chello.nl (InterMail vK.4.02.00.00 201-232-116 license 2ee4e7c625482f2f2a1950a80f6c8d58) with ESMTP id <20000628182208.FDKM159.relay01@chello.nl>; Wed, 28 Jun 2000 20:22:08 +0200 Received: (from wkb@localhost) by chello.nl (8.9.3/8.9.3) id UAA01296; Wed, 28 Jun 2000 20:21:09 +0200 (CEST) (envelope-from wkb) Date: Wed, 28 Jun 2000 20:21:09 +0200 From: Wilko Bulte <wkb@chello.nl> To: Dan Moschuk <dan@FreeBSD.ORG> Cc: Nik Clayton <nik@FreeBSD.ORG>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000628202109.E1136@freebie.wbnet> Reply-To: wilko@FreeBSD.ORG References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <20000626115008.B462@catkin.nothing-going-on.org> <20000628134936.A524@spirit.jaded.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628134936.A524@spirit.jaded.net>; from dan@FreeBSD.ORG on Wed, Jun 28, 2000 at 01:49:36PM -0400 X-OS: FreeBSD 4.0-STABLE X-PGP: finger wilko@freebsd.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 01:49:36PM -0400, Dan Moschuk wrote: > > | I disagree. We're not Linux, where people can throw in code without thought > | to the wider consequences -- one of the commitments you should make (that's > | a generic "you" there, not you specifically) as a FreeBSD committer is to > | maintain the documentation that's affected by your changes. A look at > | HARDWARE.TXT shows that (with a few notable exceptions) the FreeBSD Developer > | Community at large is *not* keeping it up to date. > > Perhaps it would be a good idea to assign someone the task of just maintaing > the HARDWARE.TXT file, rather than expecting all developers to keep > documentation up to date? That is what I am currently doing (at least trying to.. ;-) for FreeBSD/alpha. But considering that the alpha community is considerably smaller this might be a problem in the much bigger x86 world. -- Wilko Bulte http://www.freebsd.org "Do, or do not. There is no try" wilko@freebsd.org http://www.nlfug.nl Yoda - The Empire Strikes Back To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 11:45:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from spirit.jaded.net (shortbus.jaded.net [216.94.132.8]) by hub.freebsd.org (Postfix) with ESMTP id 21A8C37C198; Wed, 28 Jun 2000 11:45:32 -0700 (PDT) (envelope-from dan@spirit.jaded.net) Received: (from dan@localhost) by spirit.jaded.net (8.9.3/8.9.3) id OAA07572; Wed, 28 Jun 2000 14:45:26 -0400 (EDT) (envelope-from dan) Date: Wed, 28 Jun 2000 14:45:25 -0400 From: Dan Moschuk <dan@FreeBSD.ORG> To: wilko@FreeBSD.ORG Cc: Dan Moschuk <dan@FreeBSD.ORG>, Nik Clayton <nik@FreeBSD.ORG>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000628144525.A975@spirit.jaded.net> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <20000626115008.B462@catkin.nothing-going-on.org> <20000628134936.A524@spirit.jaded.net> <20000628202109.E1136@freebie.wbnet> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20000628202109.E1136@freebie.wbnet>; from wkb@chello.nl on Wed, Jun 28, 2000 at 08:21:09PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org | > Perhaps it would be a good idea to assign someone the task of just maintaing | > the HARDWARE.TXT file, rather than expecting all developers to keep | > documentation up to date? | | That is what I am currently doing (at least trying to.. ;-) for | FreeBSD/alpha. But considering that the alpha community is considerably | smaller this might be a problem in the much bigger x86 world. Right, but as someone that reads all the commit messages, catching new driver support and updating is more of a mundane task than anything. If maintainers emailed when they added new support (like when an entry in UPDATING is needed) it's even easier. -- Dan Moschuk (TFreak!dan@freebsd.org) "Don't get even -- get odd!" To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 12:30:27 2000 Delivered-To: freebsd-doc@freebsd.org Received: from relay02.chello.nl (relay02.chello.nl [212.83.68.146]) by hub.freebsd.org (Postfix) with ESMTP id DAA9F37C150; Wed, 28 Jun 2000 12:30:20 -0700 (PDT) (envelope-from wkb@chello.nl) Received: from chello.nl ([213.46.78.184]) by relay02.chello.nl (InterMail vK.4.02.00.00 201-232-116 license 2ee4e7c625482f2f2a1950a80f6c8d58) with ESMTP id <20000628193001.KESF26299.relay02@chello.nl>; Wed, 28 Jun 2000 21:30:01 +0200 Received: (from wkb@localhost) by chello.nl (8.9.3/8.9.3) id VAA01840; Wed, 28 Jun 2000 21:30:18 +0200 (CEST) (envelope-from wkb) Date: Wed, 28 Jun 2000 21:30:18 +0200 From: Wilko Bulte <wkb@chello.nl> To: Dan Moschuk <dan@FreeBSD.ORG> Cc: wilko@FreeBSD.ORG, Nik Clayton <nik@FreeBSD.ORG>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000628213018.E1596@freebie.wbnet> Reply-To: wilko@FreeBSD.ORG References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <20000626115008.B462@catkin.nothing-going-on.org> <20000628134936.A524@spirit.jaded.net> <20000628202109.E1136@freebie.wbnet> <20000628144525.A975@spirit.jaded.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628144525.A975@spirit.jaded.net>; from dan@FreeBSD.ORG on Wed, Jun 28, 2000 at 02:45:25PM -0400 X-OS: FreeBSD 4.0-STABLE X-PGP: finger wilko@freebsd.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 02:45:25PM -0400, Dan Moschuk wrote: > > | > Perhaps it would be a good idea to assign someone the task of just maintaing > | > the HARDWARE.TXT file, rather than expecting all developers to keep > | > documentation up to date? > | > | That is what I am currently doing (at least trying to.. ;-) for > | FreeBSD/alpha. But considering that the alpha community is considerably > | smaller this might be a problem in the much bigger x86 world. > > Right, but as someone that reads all the commit messages, catching new > driver support and updating is more of a mundane task than anything. If > maintainers emailed when they added new support (like when an entry in > UPDATING is needed) it's even easier. We can always dream, can we? ;-) I don't read all commit messages, rather procmail sifts: # want commit messages related to alpha saved :0: * ^Subject:.*cvs commit.*alpha $MAILDIR/commit-mail the alpha stuff from them. -- Wilko Bulte http://www.freebsd.org "Do, or do not. There is no try" wilko@freebsd.org http://www.nlfug.nl Yoda - The Empire Strikes Back To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 13:10: 6 2000 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 1FDD437B968 for <freebsd-doc@freebsd.org>; Wed, 28 Jun 2000 13:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id NAA10214; Wed, 28 Jun 2000 13:10:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from obsidian.noc.dfn.de (obsidian.noc.dfn.de [193.174.247.193]) by hub.freebsd.org (Postfix) with ESMTP id E337537B884 for <FreeBSD-gnats-submit@freebsd.org>; Wed, 28 Jun 2000 13:09:31 -0700 (PDT) (envelope-from schweikh@obsidian.noc.dfn.de) Received: (from schweikh@localhost) by obsidian.noc.dfn.de (8.9.3/8.9.3) id WAA17363 for FreeBSD-gnats-submit@freebsd.org; Wed, 28 Jun 2000 22:09:26 +0200 (MET DST) Message-Id: <20000628220926.A17323@obsidian.noc.dfn.de> Date: Wed, 28 Jun 2000 22:09:26 +0200 From: Jens Schweikhardt <schweikh@noc.dfn.de> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/19565: /usr/share/doc/handbook/handbook.html disappeared Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19565 >Category: docs >Synopsis: /usr/share/doc/handbook/handbook.html disappeared >Confidential: no >Severity: serious >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Jun 28 13:10:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Jens Schweikhardt >Release: FreeBSD 4.0-RELEASE i386 >Organization: DFN Network Operation Center >Environment: >Description: /usr/share/doc/handbook/handbook.html apparently has been renamed index.html. This creats dead links in the handbook itself and makes other references (e.g. from /etc/printcap) bogus. >How-To-Repeat: root@hal9000:/usr/share/doc/handbook 1 # grep handbook.html * book.html: "file:/usr/share/doc/handbook/handbook.html" book.html: file:/usr/share/doc/handbook/handbook.html</a></p> book.txt: file:/usr/share/doc/handbook/handbook.html history.html: "file:/usr/share/doc/handbook/handbook.html" target= history.html: file:/usr/share/doc/handbook/handbook.html</a></p> root@hal9000:/usr/share/doc/handbook 1 # ls handbook.html ls: handbook.html: No such file or directory >Fix: Either fix all references to /usr/share/doc/handbook/handbook.html in the known universe to index.html (tough!) - or - cd /usr/share/doc/handbook ln index.html handbook.html (the Right Thing (TM), IMHO) Regards, Jens -- Jens Schweikhardt http://www.schweikhardt.net/ SIGSIG -- signature too long (core dumped) >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 Jun 28 15:11:43 2000 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 A30EA37BA3D; Wed, 28 Jun 2000 15:11:32 -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 WAA87413; Wed, 28 Jun 2000 22:44:09 +0100 (BST) (envelope-from nik) Date: Wed, 28 Jun 2000 22:44:07 +0100 From: Nik Clayton <nik@freebsd.org> To: Josef Karthauser <joe@pavilion.net> Cc: Nik Clayton <nik@freebsd.org>, Jun Kuriyama <kuriyama@freebsd.org>, doc@freebsd.org, committers@freebsd.org Subject: Re: The website Message-ID: <20000628224406.A82810@catkin.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> <20000626230824.A388@catkin.nothing-going-on.org> <20000628002714.O35437@pavilion.net> <20000628172341.A51610@catkin.nothing-going-on.org> <20000628175547.Z33390@pavilion.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628175547.Z33390@pavilion.net>; from joe@pavilion.net on Wed, Jun 28, 2000 at 05:55:47PM +0100 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 05:55:47PM +0100, Josef Karthauser wrote: > On Wed, Jun 28, 2000 at 05:23:41PM +0100, Nik Clayton wrote: > > On Wed, Jun 28, 2000 at 12:27:14AM +0100, Josef Karthauser wrote: > > > A trick that we use is to make use of server side includes to allow > > > a crude configuration file method. > > > > Problem with that is that you then need to be running a webserver before > > you can effectively test the site -- also, you probably need to be running > > the same webserver as everyone else (unless SSI is standardised between > > different servers). > > Who's not running Apache? :) Me (and anyone else who wants to develop stuff for the website without having the overhead of having to run a webserver before you can usefully view the stuff you've created and/or changed). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 16:56: 3 2000 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 0888637C24F for <doc@freebsd.org>; Wed, 28 Jun 2000 16:55:47 -0700 (PDT) (envelope-from brett@gilliam.users.flyingcroc.net) Received: (from brett@localhost) by gilliam.users.flyingcroc.net (8.9.3/8.9.3) id QAA99503; Wed, 28 Jun 2000 16:55:41 -0700 (PDT) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14682.36989.507047.56185@gilliam.users.flyingcroc.net> Date: Wed, 28 Jun 2000 16:55:41 -0700 (PDT) From: Brett McCormick <brett@mail.flyingcroc.net> To: doc@freebsd.org Subject: porters handbook problem X-Mailer: VM 6.74 under Emacs 19.34.1 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, I followed the guide in the porters handbook and have created a working port. However, when I attempted to autogenerate the pack{ing|age} list I was unable to coax the system into installing my dependencies into the temporary directory. It appeared as though this was due to some pseudo-semantic changes in the use of the variables PREFIX and LOCALBASE which may differ from the documentation. One apparently problem was due to the fact I require perl modules for installation, and of course there is no perl directory in my temporary location. I am thinking that it would be simpler to create a packing list by hand since there are many dependencies, however I wished to notify you of the possible discrepancy between the system behavior and the documentation. However, I am using freebsd 3.2 with the latest version of ports. Hopefully this information is of some useto you, feel free to respond if you need more information. Thanks for everything, --brett To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 17:19:42 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 138B437B9FF; Wed, 28 Jun 2000 17:19:37 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA82373; Wed, 28 Jun 2000 18:19:34 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA59924; Wed, 28 Jun 2000 18:19:31 -0600 (MDT) Message-Id: <200006290019.SAA59924@harmony.village.org> To: "Thomas M. Sommers" <tms2@mail.ptd.net> Subject: Re: XML driver config file to replace LINT Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Wed, 28 Jun 2000 11:27:12 EDT." <395A1950.50ECD8D5@mail.ptd.net> References: <395A1950.50ECD8D5@mail.ptd.net> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> Date: Wed, 28 Jun 2000 18:19:31 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <395A1950.50ECD8D5@mail.ptd.net> "Thomas M. Sommers" writes: : Warner Losh wrote: : > : > Any reason that the .c/.h files of the drivers couldn't be used to : > generate this information? : : Or perhaps the other way around. No. I'm saying that the .c and .h files (likely .h) are the source to the driver and driver maintanier are 1000% more likely to keep those up to date than they are xxx.xml. Right now, with modules, you can easily not have to worry about any config issues outside of those files. Forcing a doc file just to get docs and breaking this is undesirable. Expanding what the driver writers are already doing a little seems like a smarter move. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 17:21: 1 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id E05B537BA69; Wed, 28 Jun 2000 17:20:54 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA82384; Wed, 28 Jun 2000 18:20:53 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA59947; Wed, 28 Jun 2000 18:20:50 -0600 (MDT) Message-Id: <200006290020.SAA59947@harmony.village.org> To: Nik Clayton <nik@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: Hiroki Sato <hrs@geocities.co.jp>, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Wed, 28 Jun 2000 17:31:46 BST." <20000628173144.B51610@catkin.nothing-going-on.org> References: <20000628173144.B51610@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> Date: Wed, 28 Jun 2000 18:20:50 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000628173144.B51610@catkin.nothing-going-on.org> Nik Clayton writes: : Or does loading Japanese text in to a non-Japanese aware editor scramble : the text? It can, if the user editing the text isn't careful, or the editor likes to do too many things automatically. Generally speaking, however, it shouldn't be a big problem. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 17:24:12 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 7783D37BA69; Wed, 28 Jun 2000 17:24:07 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA82400; Wed, 28 Jun 2000 18:24:05 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA59981; Wed, 28 Jun 2000 18:24:01 -0600 (MDT) Message-Id: <200006290024.SAA59981@harmony.village.org> To: Nik Clayton <nik@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: "Thomas M. Sommers" <tms2@mail.ptd.net>, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Wed, 28 Jun 2000 17:34:58 BST." <20000628173457.C51610@catkin.nothing-going-on.org> References: <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> Date: Wed, 28 Jun 2000 18:24:01 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000628173457.C51610@catkin.nothing-going-on.org> Nik Clayton writes: : On Wed, Jun 28, 2000 at 11:27:12AM -0400, Thomas M. Sommers wrote: : > Warner Losh wrote: : > > : > > Any reason that the .c/.h files of the drivers couldn't be used to : > > generate this information? : > : > Or perhaps the other way around. : : That's what I'd prefer. Any solution that relys on trying to parse : "structured comments" like that is a kludge at best. I'd rather get : all this information in to a usefully structured form now, and then : process it to produce the various output formats we need. I think that this will doom the information to always being obsolete. If the information is in the .h or .c files, then it will be looked at (and corrected) all the time by the programmers. If not, then it will rot as badly as LINT has been rotting. It has taken much effort to keep LINT as non-rotten as it has been kept. Then again, there are some comments in the kernel that are in good need of a swift kick to the head as well since they have rotted beyond all usefulness in the source they are in. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 17:28:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id C078637C2D5; Wed, 28 Jun 2000 17:28:48 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA82427; Wed, 28 Jun 2000 18:28:47 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA60030; Wed, 28 Jun 2000 18:28:44 -0600 (MDT) Message-Id: <200006290028.SAA60030@harmony.village.org> To: Dan Moschuk <dan@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Wed, 28 Jun 2000 13:49:36 EDT." <20000628134936.A524@spirit.jaded.net> References: <20000628134936.A524@spirit.jaded.net> <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <20000626115008.B462@catkin.nothing-going-on.org> Date: Wed, 28 Jun 2000 18:28:44 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000628134936.A524@spirit.jaded.net> Dan Moschuk writes: : Perhaps it would be a good idea to assign someone the task of just maintaing : the HARDWARE.TXT file, rather than expecting all developers to keep : documentation up to date? This can be difficult to do. It will take someone with enough cycles to grok the new hardware support, as well as monitoring lists for reports of trouble, etc. : Warner is the gatekeeper for UPDATING, and it seems to work rather well. Yes. Sometimes less well than other times. when I have about 2 hours a week to spend on it or more, it works a lot better than when I'm completely swamped... I think it is working because I wanted to stop the whining in -current about how hard it was to keep up with current. UPDATING has gone from a very terse warning bulletin to a less terse, fairly useful document as the rough spots in the road get written up well by others and I pick from the N different copies I get. Still, it is somewhat quirky. I'd Kinda like to see it somehow on the web pages updated in near real time (well, daily is close enough :-) : I'd take on the responsibility. Good luck! Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 18: 7:35 2000 Delivered-To: freebsd-doc@freebsd.org Received: from maynard.mail.mindspring.net (maynard.mail.mindspring.net [207.69.200.243]) by hub.freebsd.org (Postfix) with ESMTP id ED86637B550; Wed, 28 Jun 2000 18:07:27 -0700 (PDT) (envelope-from asami@cs.berkeley.edu) Received: from silvia.hip.berkeley.edu (sji-ca7-130.ix.netcom.com [209.109.235.130]) by maynard.mail.mindspring.net (8.9.3/8.8.5) with ESMTP id VAA25787; Wed, 28 Jun 2000 21:07:20 -0400 (EDT) Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id SAA44911; Wed, 28 Jun 2000 18:07:08 -0700 (PDT) To: Nik Clayton <nik@freebsd.org> Cc: Hiroki Sato <hrs@geocities.co.jp>, nik@freebsd.org, doc@freebsd.org, current@freebsd.org Subject: Re: XML driver config file to replace LINT References: <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <20000625195803.G470@kilt.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000628173144.B51610@catkin.nothing-going-on.org> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 28 Jun 2000 18:06:56 -0700 In-Reply-To: Nik Clayton's message of "Wed, 28 Jun 2000 17:31:46 +0100" Message-ID: <vqchfadwb0v.fsf@silvia.hip.berkeley.edu> Lines: 25 X-Mailer: Gnus v5.7/Emacs 20.6 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Nik Clayton <nik@freebsd.org> * Possibly. I was thinking that the only thing that would be language * specific about each driver would be the comment section. * * <comment>...</comment> * * All the other stuff is language independent. * * That being the case, it wouldn't be too hard to do * * <commant lang="ja_JP.EUCjp">...</comment> * * <comment lang="es_ES.ISO_8859-1">...</comment> * * and so on, would it? * * Or does loading Japanese text in to a non-Japanese aware editor scramble * the text? With ja_JP.eucJP, it certainly would, since that's an 8-bit encoding. If you use JIS, it should be ok (as long as people pretend they don't see all the ^['s hanging around and don't try to do anything cute). Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Jun 28 21:22:31 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ns.hongik.com (ns.hongik.com [210.124.149.130]) by hub.freebsd.org (Postfix) with ESMTP id A3F4437C3C5 for <doc@FreeBSD.ORG>; Wed, 28 Jun 2000 21:22:24 -0700 (PDT) (envelope-from nobreak@hongik.com) Received: from hongik.com (hi-195.hongik.com [210.124.149.195]) by ns.hongik.com (8.10.1/8.10.1) with ESMTP id e5T4MOG22202; Thu, 29 Jun 2000 13:22:24 +0900 (KST) Message-ID: <395ACE77.BB456E1D@hongik.com> Date: Thu, 29 Jun 2000 13:20:07 +0900 From: Seung-young Kim <nobreak@hongik.com> Reply-To: nobreak@hongik.com Organization: Hongik Internet, Inc. X-Mailer: Mozilla 4.6 [en] (WinNT; I) X-Accept-Language: ko,en MIME-Version: 1.0 To: Rasmus Kaj <kaj@raditex.se> Cc: doc@FreeBSD.ORG Subject: Re: How can I write '@' character in DocBook <screen> entity? References: <3959D980.444591D4@hongik.com> <84lmzqox8c.fsf@frodo.sickla.raditex.se> Content-Type: text/plain; charset=EUC-KR Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thank you for your answer. I found a entity ``cdata'', is it correct uses? <screen><![cdata[ ]]></screen> Rasmus Kaj wrote: > > >>>>> "SK" == Seung-young Kim <nobreak@hongik.com> writes: > > SK> How can I write '@' character in DocBook <screen> entity? > SK> I want below tags to work well... > > SK> <screen> > SK> From: Mail Delivery Subsystem <MAILER-DAEMON@marie.nobreak.com> > SK> To: postmaster@marie.nobreak.com > SK> </screen> > > The '@' sign should be no problem. But you can't have an '@' sign in > the name of an SGML tag. > > You need to encode '<' and '>' (as "<" and ">"), otherwise what > comes inside them (the mail address) is regarded as a tag. > > -- > Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ > \ Talk sense to a fool and he calls you foolish. -Euripides > \------------------------------------------------- http://Raditex.se/ -- Seung-young Kim http://www.hongik.com Enable your web site with Hongik Internet, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 0:55:18 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mimer.webgiro.com (mimer.webgiro.com [212.209.29.5]) by hub.freebsd.org (Postfix) with ESMTP id 6B96337B8FE; Thu, 29 Jun 2000 00:55:12 -0700 (PDT) (envelope-from abial@webgiro.com) Received: by mimer.webgiro.com (Postfix, from userid 66) id 7C5C12DC0A; Thu, 29 Jun 2000 10:01:01 +0200 (CEST) Received: by mx.webgiro.com (Postfix, from userid 1001) id 4FCB07817; Thu, 29 Jun 2000 09:53:04 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by mx.webgiro.com (Postfix) with ESMTP id 43C3810E17; Thu, 29 Jun 2000 09:53:04 +0200 (CEST) Date: Thu, 29 Jun 2000 09:53:04 +0200 (CEST) From: Andrzej Bialecki <abial@webgiro.com> To: Warner Losh <imp@village.org> Cc: "Thomas M. Sommers" <tms2@mail.ptd.net>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT In-Reply-To: <200006290019.SAA59924@harmony.village.org> Message-ID: <Pine.BSF.4.20.0006290949190.14781-100000@mx.webgiro.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, 28 Jun 2000, Warner Losh wrote: > In message <395A1950.50ECD8D5@mail.ptd.net> "Thomas M. Sommers" writes: > : Warner Losh wrote: > : > > : > Any reason that the .c/.h files of the drivers couldn't be used to > : > generate this information? > : > : Or perhaps the other way around. > > No. I'm saying that the .c and .h files (likely .h) are the source to > the driver and driver maintanier are 1000% more likely to keep those > up to date than they are xxx.xml. Right now, with modules, you can > easily not have to worry about any config issues outside of those > files. Forcing a doc file just to get docs and breaking this is > undesirable. Expanding what the driver writers are already doing > a little seems like a smarter move. Hmmm.. What if we define a set of macros that are required in order to properly register the driver, but at the same time contain fields like "descr", "syntax"... Something similar to sysctl descriptions.. Oops, perhaps not the best example... ;-) Andrzej Bialecki // <abial@webgiro.com> WebGiro AB, Sweden (http://www.webgiro.com) // ------------------------------------------------------------------- // ------ FreeBSD: The Power to Serve. http://www.freebsd.org -------- // --- Small & Embedded FreeBSD: http://www.freebsd.org/~picobsd/ ---- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 3:56:27 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id E771237BB8E; Thu, 29 Jun 2000 03:56:14 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (postfix@genius.systems.pavilion.net [212.74.1.100]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id LAA55230; Thu, 29 Jun 2000 11:50:24 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id A1D1C12341; Thu, 29 Jun 2000 11:51:49 +0100 (BST) Date: Thu, 29 Jun 2000 11:51:49 +0100 From: Josef Karthauser <joe@pavilion.net> To: Nik Clayton <nik@freebsd.org> Cc: Jun Kuriyama <kuriyama@freebsd.org>, doc@freebsd.org, committers@freebsd.org Subject: Re: The website Message-ID: <20000629115149.E66974@pavilion.net> References: <20000625200029.I470@kilt.nothing-going-on.org> <7mu2eg4sz7.wl@waterblue.imgsrc.co.jp> <20000626230824.A388@catkin.nothing-going-on.org> <20000628002714.O35437@pavilion.net> <20000628172341.A51610@catkin.nothing-going-on.org> <20000628175547.Z33390@pavilion.net> <20000628224406.A82810@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000628224406.A82810@catkin.nothing-going-on.org>; from nik@freebsd.org on Wed, Jun 28, 2000 at 10:44:07PM +0100 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 10:44:07PM +0100, Nik Clayton wrote: > On Wed, Jun 28, 2000 at 05:55:47PM +0100, Josef Karthauser wrote: > > On Wed, Jun 28, 2000 at 05:23:41PM +0100, Nik Clayton wrote: > > > On Wed, Jun 28, 2000 at 12:27:14AM +0100, Josef Karthauser wrote: > > > > A trick that we use is to make use of server side includes to allow > > > > a crude configuration file method. > > > > > > Problem with that is that you then need to be running a webserver before > > > you can effectively test the site -- also, you probably need to be running > > > the same webserver as everyone else (unless SSI is standardised between > > > different servers). > > > > Who's not running Apache? :) > > Me (and anyone else who wants to develop stuff for the website without > having the overhead of having to run a webserver before you can usefully > view the stuff you've created and/or changed). Ah! Developing :). In that case I vote for a post processing "branding" procedure so that site specific tweaks can be made before mirroring. This could be done in the build process, but that then makes it more difficult to mirror as each mirror site also needs the full build enviromnent. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 4:55:18 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id 4290E37BB1A for <doc@FreeBSD.ORG>; Thu, 29 Jun 2000 04:55:09 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id NAA00920; Thu, 29 Jun 2000 13:54:59 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: nobreak@hongik.com Cc: doc@FreeBSD.ORG Subject: Re: How can I write '@' character in DocBook <screen> entity? References: <3959D980.444591D4@hongik.com> <84lmzqox8c.fsf@frodo.sickla.raditex.se> <395ACE77.BB456E1D@hongik.com> From: Rasmus Kaj <kaj@raditex.se> Cc: Rasmus Kaj <kaj@raditex.se> Organization: Raditex AB - http://Raditex.se/ X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^' d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU Date: 29 Jun 2000 13:54:59 +0200 In-Reply-To: Seung-young Kim's message of "Thu, 29 Jun 2000 13:20:07 +0900" Message-ID: <84itusk8h8.fsf@frodo.sickla.raditex.se> Lines: 34 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "SK" == Seung-young Kim <nobreak@hongik.com> writes: SK> Thank you for your answer. SK> I found a entity ``cdata'', is it correct uses? SK> <screen><![cdata[ SK> ]]></screen> I don't know. When I include files (source examples, etc), I run them trough "sed -e 's/&/\&/g' -e 's/</\</g' -e 's/>/\>/g'" (or sometimes a more advanced script which recognices some keywords etc (e.g. 's#//.*#<comment>&</comment># to mark up C++ comments)) Also, I usually create entities for them, like <!ENTITY src.sample SYSTEM "src/sample.sgml"> and then use it like this: <programlisting>&src.sample;</programlisting> (the ENTITY part must, as far as I can see, be part of the DOCTYPE declaration of the document, like this: <!DOCTYPE book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [ <!ENTITY src.sample SYSTEM "src/sample.sgml"> ]> There might be a simpler way, but this is the way I do it ... -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ If I look confused it's because I'm thinking. -Samuel Goldwyn \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 6:31:25 2000 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 F001137B861; Thu, 29 Jun 2000 06:31:09 -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 DAA05520; Thu, 29 Jun 2000 03:16:54 +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 CAA49056; Wed, 28 Jun 2000 02:49:50 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Wed, 28 Jun 2000 02:48:35 +0000 From: Nik Clayton <nik@freebsd.org> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@freebsd.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000628024834.A48992@kilt.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="k1lZvvs/B4yU6o8G" Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000625200029.I470@kilt.nothing-going-on.org>; from nik@freebsd.org on Sun, Jun 25, 2000 at 08:00:29PM +0000 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --k1lZvvs/B4yU6o8G Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi guys, On Sun, Jun 25, 2000 at 08:00:29PM +0000, Nik Clayton wrote: > * We should be reusing the orange left hand bar across all the pages. > It's an accepted design standard on many websites, and there's no > reason to be gratuitously different from the crowd unless you're trying > to win design awards. > > If you take a look at http://www.demon.net/ you'll see how their left > side navigation bar expands and contracts as you move through the site, > showing you where you are in the site, and useful places you can go > from there. > > I like this. It's also not too programmatically difficult to do using > our SGML tools. Several people have called me up on that last comment in private e-mail, wondering what I was smoking when I wrote it, as they couldn't see a way to do this with plain old SGML. See the attached :-) data/ and share/ are the necessary make(1) and SGML files to do this. stage/ is what it looks like after it's built. Details about how this is all accomplished are in share/sgml/left-menu.sgml. Hope that gives someone some ideas. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery --k1lZvvs/B4yU6o8G Content-Type: application/x-tar-gz Content-Disposition: attachment; filename="orange-bar.tar.gz" Content-Transfer-Encoding: base64 H4sICBBmWTkCA29yYW5nZS1iYXIudGFyAO1d63LjNrKev9JTYJRkLrVjiZREKWvLTvmisX1i j722JtlUTipFSZDFHYlUSMoe1+68y77HebnTDfBuyvJFV7pRyVi8oAF0N4D+Gg2wWHo198Sq Sl3T2CvG1LqmRv/6SWGsrpZr5VpFUetwXavX1VdMe7WANHZc3WbslWl8ufe9ac/XNEHrr3hp 0fIXIk+Rv1ar12rwmlJWVk3+N33OB1mVv2F2+ddi3x3OpYWqolSr1Ynyr2pKJSJ/DV4rl+vl V0wh+c89NV4fnO23fjtvsqPW6Qk7/7x3crzPChul0q+V/VLpoHUgH1SLCmvZuukYrmGZ+qBU an4q7OQb+BD/NHcP4E/ruHXS3Ploc753ebDJWtxxmWH2bN1xxx13bPNGSb6Sb5S8LHtnB7+x vcP9s5Ozi+3Cdz2RCqzV/GcLLhWRCuzk+NPP3iU+/cW7/rGqKD9WC2w3/nwH1arR2t07abJf jw9aR9sF0MEfsL4tLA//XuA/B/HHjSN1J63OcDufzwHJUku08gDfxEIPP20XLo4Pj1qQd5cd XTQ/bheKkd4Et49PD9nlxT7eH1hX1p/OUB8MildGD2sNTfSYVWB7ZxcHTWCBAplKuzuiVK/A kqhtya97SbQMqjShmRFSbL95cnJ5vrt//OkwuD7fPTgQ1+U0joSy+PvfBfN3/hu0m/3iNbp1 dl6ISa3TqdWAWr5xvtPYOz6MssPkN06cJ3s7n+Beo7TntVRk2LvA7KXzdCJdq5OkcWB1xkNu ujpq5KOIXXOza9l3KvWLvD2JVMiFuw3/b/pDocsT+RfTvZwQ5lF5p9XnrG8NORvByAxaUJa6 Bw/P4ZnhMPjPweeOPhwNOHP5V7fI2PRHkgp7WuboI5/Q1MxTyPp0ntog8Sho1cwa9HQm39sg oY3iBRJnVsRJksxix7x30sXn/i1p/GTA/sfZdVXwH9r/Sr2qEf5brPznhwGn4D9NVdSE/CtK hfDf+uO/hIW+6tAvUd3Hob6JsO+l4r7ZAL+nIT/JocvT3ZOTnf9jSWo9/a8YxY+7/xAEMGsu n7uboa+b3bZlfYnlOvJuYlZZXkkW6F1Mas/Kg89ulLuEQrMIW1gkNY4qoX5O6holeInA60vR gqnjndQHUgVCv/lXlLKB/3DoXxX8r2pqlfD/4uU/Hx/AtPXfWjW5/lupqRXC/1nA/5tMmJBr AP29mj4W9d8H/F8w9p8Z/J+JBwAlm4ru5wHw1wHjA0MI2dP6MomT1pdJki8ZYYf2fzAHrgD+ K2u4/kf4b5H4L8UGWhT+Q5nH5F+tVTTCf9nAf2huhqb0WgDBeJUJEWYQEaYQnLos7KtE1sCg 3y5ChIQISZyECEmSLwcRSvtfTMwrFP+rqhqt/y0Q/yUMs0XH/6p31v/K1Srhv7XHf9K2X3XI J2tJ0b4LjPadjMUEFd00rbHZ4TFyu95NBHlOAMySC3oi/8jmTrwu53iHdaxrbguM87gVvVlu Pl0DPIg8JCz4oiI+H9jjKAz4JSnFpGF0PzKMUiQwoVKKBM4E/gvmgBVY/63XaP13afKftSNg 2vpvvZyUv6ZotP6bDfy/yRJm5Dq4A+5UmtaAl7EGHHcTxEWSBv7nhf9n7gJYBy9AjN3kDqCl YRInLQ2TJDMGwiP2v5w1V2L9t1xRFcJ/C8Z/Satpcfs/68n132pVpfOfsoL/hO29LrjPqyzh veXjvTRCj1wZjsM+gnxTIJ9kF0E9gnokToJ6JMkXsN4q7X9/ZlqF+F/8/otaq9H3XxaI/+5a JguM/wXdKCfkXxHrv4T/1hz/BZbtqmO/oKIUBby2Z/7OMuB2MhD1aTlWz73R7TgQvfRuBhhU DnDen3RCfd3u3iF05N0Mwex9JDqW6YwHrmFexYjsB7fDbaxTKjM0nDjjT+FGMVguvQueFwhO pbgInb6oENR7u1k4v1Bo8os7ofieUfOuXpBKZAkvT1aLqTMhu+T2tdHhUd2IUXuuirBYer6m xOk9W2Hi5J6nN4mmzrqVz9CiB7Ryyvgy2RAipXnxSpOl7RFx/09gbi3Z/1fR8Pxn8v8tTf4z dQRO3f9fTfr/tJpC8f+Z8f9tstAxsiaewGiVKRYkE+e/zTg0I+4iDLRlitdvNo6/mfr+1sT9 l3T6kCOQwlRInBSmQpKkYwEozQj/BTbJsvF/VasR/l+i/JeN/zVNIfyfHfwfwpq1wf9hlQn/ E/5/5F6VZ0UJBZpH+D92SH18cZ/wP+F/Eifhf5Ik4X9KM8J/EWtiqfi/qlQJ/y9X/jP0AEzF /3U1If+aWqX9PxnC/6kBmGvjCkitPXkFyCuwSK/AbKIIIn6BDPgEUjomuQXILUDiJLcASZLc ApQei//EZD/zMh6P/8sAAAn/L0n+i/7+u6ZWakn/T11VCf9nB/97mGFtEL9XX8L4hPHXD+PP NFJA9IQVWv0X9SGQTyCfxEkgnyRJIJ/S8/Bff+bh/k/H/6pSrwBQZKqi1mj//wLlP/xSWi35 a3X6/uNi5X/D28Xhl7mUAfZ87R7/T7msiPgPtQ6pJv1/Cvr/yP8z//Rd/jsmRZ//Lp/fP98W Iim1DbPUGeX3j07PDrb96/7Q6uZPfz44vtjOiTvDL13DzgOFy8PTEwYA85rbDoDw/P5ua/fk 7PAneG/s2KWB1dEHJalqztVwUELoWerorj6wrvKY+dPZxenHk93Dy+3cRpd9/2//3tl56/Ib 2+jALY/mt+D97RzSMi17iFXYs4wBt9looLuc9eC3w9y+7jJ9MIAfXFZR3u/yEWBiBvXcOzs+ aUJrcqU+2D4l0AH0VPw5itZ1wHvun0Nujot46WX52/Z9WdqiLqIqMlO+aPQY/2o4rvMuTu99 SDBRUBHqaPQg6+Xnjx+P/9m83GTFf4341cZ4zBk6kOQPvCUumcjGBKyHXP6r4sdmPjced3nH 6nLgZBFQ/OXF/jd4yyODfye+g2QF1U24L2v7LZ8LZfQtIi8hQ7xRPD49x/xsBy9auxeHzRYQ A2kgFbQO8a3D44/453/Om4f49/wALv+8/LwHKvb5spnPGyb0TsyCUow8yP3OhJocNC9bcOsb +4P95z9wLZQT9GUUeZbP9SxbSJ4ZZqRsv1CvDlj2Futa7H/zOWjc/jmQ6bHvvxcZQ2oleWfL fw07yDeG7u30d7qWyUE9QUF3zVsGQ80Vdz3NDNQQLsH6hhfZjQHtbHNmj01m884YetM1H9xC bqi6r8nOuA3djndcyzZAmwegVbwr2yY59A3KC5kFaoMsQw3s8p5h8u47+ew9e/OGvebDkXvr 35G8kgXEKAacedcBvn8v39hCju/+3PzGvJZvF4ulGBs8SqEGvA+Z4uk3meArMP+LUWuF7D9V LWtk/y1Y/vH5Z3H2X61W14L1v5qK8q+CJpD9t5j1v40NdgKSZ30dJiMUv7eSIPxGYrb6a2y4 OHm63OaOiLaTd+DfzpfBbTHIwNkgRgl+wVxnMX004rqYUNy+zWEGc8Eycvx8apGxXVdMba41 AhIw5TGrJ+c6KOcDM1w0Lh00n/BBn+tdqIXzAeZLt89MKzy7ESacDSzZAZr7A6geTq+6nwPr MrSuOUxmNyZeyLLKfk3Ksibe3Q+iBqId/OsI2iTa4vStG6CIsy7WBQt0YC4Gq9dht9Y4rEpH N9mVBVn85gE7RxZwUZLVgRt+tXDSFc89SuiMg1bl2MAyr8Co7WBL9DYYIu9uwHJ46wgSgtgH LPStzcE6sIHarWQy9ym9/wBUUBwR40EyCGRzjQwHc6ODfj8d3r/mPicqUU5UZCHwuqgIFzYL miu+kCJMb6Fl498ImeEpQt+46g/gfxerKdyNN/otPjDAFuig5S4sIyhNVo8LnetCG8R9nz0R 5YAij0HC3a5Ylxaq4pUl2wVZTcvciHBQvwLWg+okGIlEh/oXFAfQQAGbX+AlbgKFBIshD1xt 4Hv/guEDdbM3drgkBj9s573PxyNQFrCcblDlpIiFygI0AAag0fyT9+KvfDD4gO9Bfii9PTY7 fazSSLf1IQcuIC+gjRy0vmcNBtYN1lRnzoh3jJ7RYaY+hDuSmNPp82Egy6YOpETuW+x5NnSi wg+DYbHA3hUGwwLbZgXRbVFihffR3mzyr9i64QiEDRwyZAuhpFD0nkRuODLIMEEcH0GZ+Vfh Rf4gSYnSulan4HujoQ+NB12gbMOAAsS7kitI0Ldsb1OLkfRkYeKrftDk2PCjO9MqHPbXaKV3 pVK4wUGwYd2cSZWLFIxkpAWfkNctG8FPGNY2ZFdCHn8QHRLoyU40tCA3jACSGLwF5CGv7XVl XQoG6rh3iwa8Ph5Ap+cRmfqgweEwtHhjYeH4EOBYM+D4kOumBzsAB+hiARVUkjvmW9B8KNM2 APbp5i1wAMdJrBz8c+sxHEsQqg7zQTCUhK3yB2SfI8eS1yj2nmE77pZfVTHEYS2hgp/2Tz4f NAtBWYGQxYjry8EwOwNApQLfGNhhkZLN3WDW+WiYUKFbOVj3b4HdoucKGIvjquAUkEYtC2UA tPgQq3Nj4+QkyEt6QaWLMtOWz0KP92Js8Sr/AcYwydRY4Y5kmKQHgnHHtikHzQ3ZBnxbapdj tI0BcsZTTxwHr42uPpASgqIws6QkUWKvJ0YlHHxudBOqY7iOHKzg5a7hyLk20DGxkCOHQyjS 7OJw6tVMx0nGHuoDn5X70HEGYhjufoARyGW81+NyWmAbGxhCMdpptI2rnQbMqDbvbRfetHWH b6VEd7S96I72TqOkw/8iV9tGGq9/FzzGPFvsdy+aQkTF7Lz5Tv2xvsWirxT9L37Cuw09n7tb buonQf/4I/FV0Ne/53OpNKF68LKsWy6tAuKzyF7pLKXdyc8mi8LjHx4VpbMUkrJwL6BC8kBc 4M1GaXQPy+/EwbSTcTCTWQ95p3Ae3ij29L/SeI4Fw6Nkgz/u/iMlc4S5uTvcxffQVGxb1pd0 /mJZ/hvJAo+8+xHeJgk+nbupQUHtMChoMm+9nFP4671V9KOE0hh9byQRNCEIJppEM5+LCSAW azShPn6k0X31SY1GEgLxApL8rpZGNNrb7q1JGK0k6xIYkmlVmhDaBCVFopugWj6RyQVFFXYa szBY9gGVu7OBCgqQ8YUTauTTjajvBP2dLf5Peq0Xhf8r5Sj+r9fF998rdP734vD/Hu9ZwhJG W8uz/6THHJGYZ61L57F8FAAQH5RsBl/EQOVniXSuowFtCesRTRo0fyzL9Y2eG95mrs15QANo DpJE/NkNzSd8nM9Lk+R181PruPWbsEHB1H7bwB/eoC9eDMOR34jrrUZJ3hfxKv7beNG2ANy1 rzrWwLIj4choQUXCkdHWioQjX3vXXjiyKFiPv+PXRuDPG6Pr9oOYZO8DIi4WDUNOw5UDT8Pt xl9s9NWdoPp9PyzZ7eIDLO7K3C7YCKwLd+ay2BxmDK/yOcjq2J3ghWRYsj5ww7Bk8XbbsoG3 Xmgyznt9DE2G0qHGJTeYW+C3bId3ge31o5TvNj5ClXUA/TojvQMqFVyPENTjdXkCnyIfYAF2 hXLzw5bfmG1ntCXrmXj52mMZQJhCTOIyePUN4mHhwUjPnpJjcll3FCr+coq0Y9XbeRvV8h50 G6HlD+U+/hS3JRno7E2vy2JPhMnPtS0J5+KuO0A98f71A/OsVzYl+dBzJyVvYHlPzOuhwtTM wmy+r+AgcyI3GIbsqdX2rNkpeSdUO2qRPr7ankHwpGonrcFHVTtpuT0pc2hYPSEz2kDTGUbL d89OXd3V5xz+95j9f3WlquInoesU/7VA+Qs/xgrJX1XqdP7TouUv7cQZL/0+CP9p5bq3/q/W K/L8b0Wj858WhP/8/Z+IEB65/xOdXMH8LYBfoViMzukSyBXQF1xINyZTrZ/A/GaXv122mqfM 28o2MVghbkdEHBmTCSS9HUDih8i9rfwfuNWvgVyRJvUbiTC3vJ0QfbkxTTRCbkfrh9vRRrTr Za13vYySX/jsV0JcnbrgEF9tkCA58UFqUooMK8XdVSC5BLTvLwEFKkHakBVtiHTuN9Ixs5Vv iNj2nTW0/071Lxx9vgvf/8HKNc23/2o1RcP9H9Vajey/Re3/uJSa7SuAjMcSgfdsiB4cfCh3 ThhmeCcSg45bR9BK3M6FA2A+78WB/7TNPOMLj5rJ52VE+XYu58+j3p2/befEIIqbJWTQR9xq C/YoFShmfB79PzBrVgD/lzWNzn9alvxn7giYhv+r5Wow/lfrCq7/wl8a/9cT/5cmugA2WQwl TfcI3LeAFC58TPcbzMJ1MBfvQYwf5EbINkYgcWbAAUCSJPCecftv5o6Aqfi/UvbtP03a/1VA AmT/ZQz/hy6AOwifQP7y+7/0YK/G+n9ZVSj+Yynyn0cUwFT8r5RD/29F4H+1RuN/BvG/WBN7 Eu6XsZ+ZAP1yYZDAPoF9EieBfZLkcsH+C8cZSftvHlEAj8f/lZpC+/8I/1NaTP+fX+j3g/Bf JP6nWq2J+B+lTvHf64n/UrBfizt44FPP1h133HHHNp8O4J4H3WYP2vCwV8JshNlInITZSJK0 QJsp+w/PWZpjGU/Y/6lV6rT+s1D5B+dsrcT6X6VM8b9Lkv/sweDU9T81iP+t18oi/qOqkv8n U+t/B1Znk8kvOUo9Sz+l5WEnqWRiGdBnBKFKQpUkTkKVJElaCVwF+2/2K4BPiP9VyhT/Ret/ lBbX/+e4BviY859gAED8X6Pzf9cV/6WDv/Bk+qnAby3PgepGm0iQ7kWd/ZP8HAJ+C4FOgHpp WpD6oYrgKxV0/BNByZW2/+Z3/NMDzn+qhP7/Kn7/oVyu0fe/s4b/kuc/wbQZHv3kj550+tOS +j8aMSuz/q9WFDr/efHyn5MPYBr+r9TVEP9rFYz/r1L8fwbXfwEYPWHZF7++kYkVX2g+eQZo sZfESYu9JElC6Ktn/83JB/CE/Z+KqpL9R+u/lBbS//1P1a4O/q9qdP7T4uUffNp52fKvlKu0 /2OJ8p+tI2hq/H+l6stfq6MvSNUqWoXm/yz5f36RKrbJ/M/ET/7c6cM/S5qRfQBeazwWkYuI XEQkTnIRkSTJRbQs+2+2jqAnxP/X6fuv5P+htOD+PzSczmrs/xfr/4T/lyH/Jez/L1d8+dcU Db//XYV5gMb/TOL/U9Cx4jPAP+poxoC/YAnBfoL9JE6C/SRJgv1Ltf9WYv+/qipk/xH+p7TQ /r+c+H+tXq0H67+1Kp7/XdHo+0/riv8mg78Hob613P0vG0gQ7kVt+HasnhuJlpEbvi+9m/5q Ph0E8AIPAohFUfkHAcSjPOhAgGyCyslq0bFMB21n8yqmGPvBbXbJ7Wujw6O6EaP2XBVhsfR8 TYnTe7bCxMk9T28STZ11K5+hRQ9o5ZTxJbJKI1VI+I9JaUhpQPSP9WnF8N+S9v9UfP8P4D+t LvCfWif8lzX/T/L8D99+jh4CIo2k8E44aYb3cPyjY0Lm4f8JEM2y4z8qFYW+/7BE+S9x/wd+ C0LV6PyPrMZ/+A6SZ4SA+GqajTCQpMeIvIgUCELipEAQkiQFgizL/lv2/g9NUQj/U/wHpcX2 /8gSxZLxf42+/7lc+c/SAzAV/2vVcP9HRcHxv16h/X/ZxP8p653PcAWEGpsNZ0AKd8gfQP4A Eif5A0iS5A9YnP03Sw/AE/B/pUr2H+F/Sovp/3P89s+D+n89iP+pqYo4/5P2/2es/yeDf7pW J4zoMfmNE155s1FilKDxgRIlSpQoUaJEiRIlSpQoUaJE6Unp/wEEO8Y1ALgBAA== --k1lZvvs/B4yU6o8G-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 8:26:41 2000 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 2101C37B78D; Thu, 29 Jun 2000 08:26:34 -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 OAA29040; Thu, 29 Jun 2000 14:42:58 +0100 (BST) (envelope-from nik) Date: Thu, 29 Jun 2000 14:42:57 +0100 From: Nik Clayton <nik@freebsd.org> To: Warner Losh <imp@village.org> Cc: Nik Clayton <nik@FreeBSD.ORG>, "Thomas M. Sommers" <tms2@mail.ptd.net>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000629144257.A23415@catkin.nothing-going-on.org> References: <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <20000628173457.C51610@catkin.nothing-going-on.org> <200006290024.SAA59981@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200006290024.SAA59981@harmony.village.org>; from imp@village.org on Wed, Jun 28, 2000 at 06:24:01PM -0600 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jun 28, 2000 at 06:24:01PM -0600, Warner Losh wrote: > In message <20000628173457.C51610@catkin.nothing-going-on.org> Nik Clayton writes: > : On Wed, Jun 28, 2000 at 11:27:12AM -0400, Thomas M. Sommers wrote: > : > Warner Losh wrote: > : > > > : > > Any reason that the .c/.h files of the drivers couldn't be used to > : > > generate this information? > : > > : > Or perhaps the other way around. > : > : That's what I'd prefer. Any solution that relys on trying to parse > : "structured comments" like that is a kludge at best. I'd rather get > : all this information in to a usefully structured form now, and then > : process it to produce the various output formats we need. > > I think that this will doom the information to always being obsolete. > If the information is in the .h or .c files, then it will be looked at > (and corrected) all the time by the programmers. If not, then it will > rot as badly as LINT has been rotting. It has taken much effort to > keep LINT as non-rotten as it has been kept. The .h file(s) should be generated from this XML config file, or some other mechanism needs to be put in place to prevent a (hardware) module from working if there isn't a functional entry for it in this XML config file. We've successfully demonstrated that hardware authors don't keep things like LINT up to date. We've also successfully demonstrated that getting volunteers to scan the mailing lists and keep HARDWARE.TXT and similar up to date is equally futile. It's time to turn the tables. I don't know enough about the -current build environment to say precisely how this could be done (yet). But God help you all if I scrape together sufficient resources to put together a box for -current. In the meantime, I'd appreciate suggestions as to how you (or anyone else) would go about abstracting some of the core information that a driver needs out of a source file. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 8:58:32 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id BD1F137BC0D; Thu, 29 Jun 2000 08:58:19 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id JAA86152; Thu, 29 Jun 2000 09:58:17 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id JAA34002; Thu, 29 Jun 2000 09:58:11 -0600 (MDT) Message-Id: <200006291558.JAA34002@harmony.village.org> To: Nik Clayton <nik@freebsd.org> Subject: Re: XML driver config file to replace LINT Cc: "Thomas M. Sommers" <tms2@mail.ptd.net>, doc@freebsd.org, current@freebsd.org In-reply-to: Your message of "Thu, 29 Jun 2000 14:42:57 BST." <20000629144257.A23415@catkin.nothing-going-on.org> References: <20000629144257.A23415@catkin.nothing-going-on.org> <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <20000628173457.C51610@catkin.nothing-going-on.org> <200006290024.SAA59981@harmony.village.org> Date: Thu, 29 Jun 2000 09:58:11 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000629144257.A23415@catkin.nothing-going-on.org> Nik Clayton writes: : The .h file(s) should be generated from this XML config file, or some other : mechanism needs to be put in place to prevent a (hardware) module from : working if there isn't a functional entry for it in this XML config file. : : We've successfully demonstrated that hardware authors don't keep things : like LINT up to date. We've also successfully demonstrated that getting : volunteers to scan the mailing lists and keep HARDWARE.TXT and similar : up to date is equally futile. : : It's time to turn the tables. I'd violently oppose this. I'd rather see the XML file generated from the .h files that we already use to build the system with. You would be making it just as hard to keep things up to date with little gain from the programmer's point of view. You need to make it easier for the programmer to keep things up to date rather than harder. : I don't know enough about the -current build environment to say precisely : how this could be done (yet). But God help you all if I scrape together : sufficient resources to put together a box for -current. : : In the meantime, I'd appreciate suggestions as to how you (or anyone else) : would go about abstracting some of the core information that a driver needs : out of a source file. While I hate the idea, I'd love to see what you'd come up with. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 9:47: 1 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout1.silyn-tek.de (mout1.silyn-tek.de [194.25.165.69]) by hub.freebsd.org (Postfix) with ESMTP id 6153737BD79; Thu, 29 Jun 2000 09:46:56 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.34] (helo=mx2.silyn-tek.de) by mout1.silyn-tek.de with esmtp (Exim 3.13 #1) id 137hSp-00017R-00; Thu, 29 Jun 2000 18:46:55 +0200 Received: from p3e9c1121.dip0.t-ipconnect.de ([62.156.17.33] helo=neutron.cichlids.com) by mx2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137hSk-00063U-00; Thu, 29 Jun 2000 18:46:50 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id D8A0EAC27; Thu, 29 Jun 2000 18:47:06 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id 7BF6714A67; Thu, 29 Jun 2000 18:46:50 +0200 (CEST) Date: Thu, 29 Jun 2000 18:46:50 +0200 To: committers@freebsd.org Cc: doc@freebsd.org Subject: NOTES reorganization Message-ID: <20000629184650.A14852@cichlids.cichlids.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. From: alex@big.endian.de (Alexander Langer) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello! [Not sure, where this belongs, so to -committers + -doc] Since NOTES is more docu already, I'd like to reorganize its structure. Currently, many drivers support more than one bus of ISA, EISA, MCA, PCI. At the moment, we have, for example, some SCSI devices listed more than once, iirc, some up to three times (ISA/EISA, MCA, PCI). Since now the "device" line is common for all of them and they only differ for the hints stuff, I did the following: First, list Busses: (E)ISA, MCA, PCI and explain, that only (E)ISA needs the hints stuff. Move NIC/SCSI stuff, which were the only split sections, behind these stuff. Describe all drivers only one time and list all supported chips. List all device (+ hints for (E)ISA, if possible). I've also added few additional supported chips to some drivers, xl for example and some SCSI drivers. The patches are at http://people.freebsd.org/~alex/NOTES.diff -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 9:50:11 2000 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 C6A3137BEA5 for <freebsd-doc@freebsd.org>; Thu, 29 Jun 2000 09:50:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id JAA29044; Thu, 29 Jun 2000 09:50:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by hub.freebsd.org (Postfix) with ESMTP id 3ADC937B711 for <FreeBSD-gnats-submit@freebsd.org>; Thu, 29 Jun 2000 09:43:54 -0700 (PDT) (envelope-from bmah@cisco.com) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.10.2/8.10.2) id e5TGhqu59386; Thu, 29 Jun 2000 09:43:52 -0700 (PDT) (envelope-from bmah) Message-Id: <200006291643.e5TGhqu59386@bmah-freebsd-0.cisco.com> Date: Thu, 29 Jun 2000 09:43:52 -0700 (PDT) From: bmah@cisco.com (Bruce A. Mah) Reply-To: bmah@cisco.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19583 >Category: docs >Synopsis: [patch] Fix typos in RELENG_4 README.TXT >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 Jun 29 09:50:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Bruce A. Mah >Release: FreeBSD 4.0-RELEASE i386 >Organization: Cisco Systems, Inc. >Environment: RELENG_4 >Description: If I'd done a proper job proofreading in my last PR for this file, I'd have caught these problems too... 1. Fix repeated "from". 2. Whitespace changes. >How-To-Repeat: >Fix: Index: README.TXT =================================================================== RCS file: /usr/local/cvsroot/src/release/texts/README.TXT,v retrieving revision 1.9.2.3 diff -c -r1.9.2.3 README.TXT *** README.TXT 2000/06/26 15:46:18 1.9.2.3 --- README.TXT 2000/06/29 16:40:35 *************** *** 32,38 **** getting into here (e.g. you've been following -stable) then this snapshot is probably for you. If you're more interested in doing business with FreeBSD than in playing with the cutting edge of ! technology, however, then 3.x or one of the 4.x releases, is almost certainly your best bet. Most information here is also available from the Documentation menu --- 32,38 ---- getting into here (e.g. you've been following -stable) then this snapshot is probably for you. If you're more interested in doing business with FreeBSD than in playing with the cutting edge of ! technology, however, then 3.x or one of the 4.x releases, is almost certainly your best bet. Most information here is also available from the Documentation menu *************** *** 52,58 **** If you are installing from floppies, it is especially important that you read this section! - HARDWARE.TXT Information about the configuration of the GENERIC kernel and supported hardware. New installers should read this file. --- 52,57 ---- *************** *** 75,87 **** you can also install one of our "snapshot" releases. For the most up-to-date software along the RELENG_3 branch ! (also known as 3.5-stable), please install your snapshots from from: ftp://releng3.freebsd.org/pub/FreeBSD/ For the most up-to-date software along the RELENG_4 branch (also known as 4.0-stable), now proceeding towards the release ! of FreeBSD 4.1, please install your snapshots from from: ftp://releng4.freebsd.org/pub/FreeBSD/ --- 74,86 ---- you can also install one of our "snapshot" releases. For the most up-to-date software along the RELENG_3 branch ! (also known as 3.5-stable), please install your snapshots from: ftp://releng3.freebsd.org/pub/FreeBSD/ For the most up-to-date software along the RELENG_4 branch (also known as 4.0-stable), now proceeding towards the release ! of FreeBSD 4.1, please install your snapshots from: ftp://releng4.freebsd.org/pub/FreeBSD/ >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 Jun 29 10:19: 4 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sasami.jurai.net (sasami.jurai.net [63.67.141.99]) by hub.freebsd.org (Postfix) with ESMTP id 60D4A37C0C7; Thu, 29 Jun 2000 10:18:46 -0700 (PDT) (envelope-from winter@jurai.net) Received: from localhost (winter@localhost) by sasami.jurai.net (8.9.3/8.8.7) with ESMTP id NAA91180; Thu, 29 Jun 2000 13:18:25 -0400 (EDT) Date: Thu, 29 Jun 2000 13:18:24 -0400 (EDT) From: "Matthew N. Dodd" <winter@jurai.net> To: Alexander Langer <alex@big.endian.de> Cc: committers@FreeBSD.org, doc@FreeBSD.org Subject: Re: NOTES reorganization In-Reply-To: <20000629184650.A14852@cichlids.cichlids.com> Message-ID: <Pine.BSF.4.21.0006291317390.896-100000@sasami.jurai.net> 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, 29 Jun 2000, Alexander Langer wrote: > First, list Busses: (E)ISA, MCA, PCI and explain, that only (E)ISA > needs the hints stuff. Only some ISA drivers need hints stuff. EISA doesn't. -- | Matthew N. Dodd | '78 Datsun 280Z | '75 Volvo 164E | FreeBSD/NetBSD | | winter@jurai.net | 2 x '84 Volvo 245DL | ix86,sparc,pmax | | http://www.jurai.net/~winter | This Space For Rent | ISO8802.5 4ever | To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 10:23:53 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout2.silyn-tek.de (mout2.silyn-tek.de [194.25.165.70]) by hub.freebsd.org (Postfix) with ESMTP id 63D6A37B810; Thu, 29 Jun 2000 10:23:42 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.34] (helo=mx2.silyn-tek.de) by mout2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137i2O-0005kg-00; Thu, 29 Jun 2000 19:23:40 +0200 Received: from p3e9c1121.dip0.t-ipconnect.de ([62.156.17.33] helo=neutron.cichlids.com) by mx2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137i2L-0006YX-00; Thu, 29 Jun 2000 19:23:37 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id 7EDF8AC27; Thu, 29 Jun 2000 19:23:49 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id 1670214A67; Thu, 29 Jun 2000 19:23:32 +0200 (CEST) Date: Thu, 29 Jun 2000 19:23:32 +0200 From: Alexander Langer <alex@big.endian.de> To: "Matthew N. Dodd" <winter@jurai.net> Cc: committers@FreeBSD.org, doc@FreeBSD.org Subject: Re: NOTES reorganization Message-ID: <20000629192332.A16005@cichlids.cichlids.com> References: <20000629184650.A14852@cichlids.cichlids.com> <Pine.BSF.4.21.0006291317390.896-100000@sasami.jurai.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <Pine.BSF.4.21.0006291317390.896-100000@sasami.jurai.net>; from winter@jurai.net on Thu, Jun 29, 2000 at 01:18:24PM -0400 X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thus spake Matthew N. Dodd (winter@jurai.net): > > First, list Busses: (E)ISA, MCA, PCI and explain, that only (E)ISA > > needs the hints stuff. > Only some ISA drivers need hints stuff. > EISA doesn't. Uh *blush* right. I'm going to change that. Alex -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 12:33:34 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 906CD37B5EA; Thu, 29 Jun 2000 12:33:22 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id NAA87165; Thu, 29 Jun 2000 13:33:20 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id NAA35699; Thu, 29 Jun 2000 13:33:14 -0600 (MDT) Message-Id: <200006291933.NAA35699@harmony.village.org> To: alex@big.endian.de (Alexander Langer) Subject: Re: NOTES reorganization Cc: committers@FreeBSD.org, doc@FreeBSD.org In-reply-to: Your message of "Thu, 29 Jun 2000 18:46:50 +0200." <20000629184650.A14852@cichlids.cichlids.com> References: <20000629184650.A14852@cichlids.cichlids.com> Date: Thu, 29 Jun 2000 13:33:14 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000629184650.A14852@cichlids.cichlids.com> Alexander Langer writes: : First, list Busses: (E)ISA, MCA, PCI and explain, that only (E)ISA : needs the hints stuff. Only ISA needs hints. EISA, MCA, PCI, pccard and cardbus are all self identifying buses. : Move NIC/SCSI stuff, which were the only split sections, behind these : stuff. Describe all drivers only one time and list all supported : chips. For pccard (and eventually cardbus), I'd like to see all supported pccards as well. I can help with that, and I think the nomads would also like to see this. PAO had a wonderful database of card support, and I'd like to see that merged into regular FreeBSD as well. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 12:39:36 2000 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 4942337BFBC for <doc@FreeBSD.ORG>; Thu, 29 Jun 2000 12:39:30 -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 SAA85708; Thu, 29 Jun 2000 18:23:38 +0100 (BST) (envelope-from nik) Date: Thu, 29 Jun 2000 18:23:37 +0100 From: Nik Clayton <nik@freebsd.org> To: Seung-young Kim <nobreak@hongik.com> Cc: Rasmus Kaj <kaj@raditex.se>, doc@FreeBSD.ORG Subject: Re: How can I write '@' character in DocBook <screen> entity? Message-ID: <20000629182336.A85504@catkin.nothing-going-on.org> References: <3959D980.444591D4@hongik.com> <84lmzqox8c.fsf@frodo.sickla.raditex.se> <395ACE77.BB456E1D@hongik.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <395ACE77.BB456E1D@hongik.com>; from nobreak@hongik.com on Thu, Jun 29, 2000 at 01:20:07PM +0900 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Jun 29, 2000 at 01:20:07PM +0900, Seung-young Kim wrote: > Thank you for your answer. > > I found a entity ``cdata'', is it correct uses? > > <screen><![cdata[ > ]]></screen> Not exactly. It will do what you want, but using a marked section in this instance is really just overkill. You might want to read the FDP Primer, at http://www.freebsd.org/tutorials/docproj-primer/ In particular, look at section 3.8. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 15:41:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ptd.net (mail1.ha-net.ptd.net [207.44.96.65]) by hub.freebsd.org (Postfix) with SMTP id D6A2337C1B1 for <doc@FreeBSD.ORG>; Thu, 29 Jun 2000 15:41:42 -0700 (PDT) (envelope-from tms2@mail.ptd.net) Received: (qmail 19473 invoked from network); 29 Jun 2000 22:41:47 -0000 Received: from du36.cli.ptd.net (HELO mail.ptd.net) (204.186.33.36) by mail.ptd.net with SMTP; 29 Jun 2000 22:41:47 -0000 Message-ID: <395B9762.5B95A329@mail.ptd.net> Date: Thu, 29 Jun 2000 14:37:22 -0400 From: "Thomas M. Sommers" <tms2@mail.ptd.net> Organization: None X-Mailer: Mozilla 4.72 [en] (X11; I; FreeBSD 4.0-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: Warner Losh <imp@village.org> Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT References: <395A1950.50ECD8D5@mail.ptd.net> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <200006290019.SAA59924@harmony.village.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Warner Losh wrote: > > In message <395A1950.50ECD8D5@mail.ptd.net> "Thomas M. Sommers" writes: > : Warner Losh wrote: > : > > : > Any reason that the .c/.h files of the drivers couldn't be used to > : > generate this information? > : > : Or perhaps the other way around. > > No. I'm saying that the .c and .h files (likely .h) are the source to > the driver and driver maintanier are 1000% more likely to keep those > up to date than they are xxx.xml. Right now, with modules, you can > easily not have to worry about any config issues outside of those > files. Forcing a doc file just to get docs and breaking this is > undesirable. Expanding what the driver writers are already doing > a little seems like a smarter move. I was thinking of something analogous to the way syscalls.master is used to generate several files. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 15:44:28 2000 Delivered-To: freebsd-doc@freebsd.org Received: from florence.pavilion.net (florence.pavilion.net [212.74.0.25]) by hub.freebsd.org (Postfix) with ESMTP id 9F6C437C20B; Thu, 29 Jun 2000 15:44:08 -0700 (PDT) (envelope-from joe@pavilion.net) Received: from genius.systems.pavilion.net (genesis.tao.org.uk [194.242.131.254]) by florence.pavilion.net (8.9.3/8.8.8) with ESMTP id XAA15353; Thu, 29 Jun 2000 23:41:46 +0100 (BST) (envelope-from joe@pavilion.net) Received: by genius.systems.pavilion.net (Postfix, from userid 100) id B776B12A48; Thu, 29 Jun 2000 23:43:10 +0100 (BST) Date: Thu, 29 Jun 2000 23:43:10 +0100 From: Josef Karthauser <joe@pavilion.net> To: Nik Clayton <nik@FreeBSD.org> Cc: Poul-Henning Kamp <phk@critter.freebsd.dk>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000629234310.D88004@pavilion.net> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> <20000627100415.E316@kilt.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000627100415.E316@kilt.nothing-going-on.org>; from nik@FreeBSD.org on Tue, Jun 27, 2000 at 10:04:15AM +0000 X-NCC-RegID: uk.pavilion Organisation: Pavilion Internet plc, Lees House, 21-23 Dyke Road, Brighton, England Phone: +44-845-333-5000 Fax: +44-845-333-5001 Mobile: +44-403-596893 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Jun 27, 2000 at 10:04:15AM +0000, Nik Clayton wrote: > > Don't know if CVS can even do this. Joe K had a prototype implementation > that does this, but as I recall it needed a backend database and took a > few hours to index the source tree. > I was working directly off the repository, another aproach is to work off the commit logs. Either way once whatever backend is populated it should be possible to update it incrementally. Joe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 15:59:44 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rly-ip01.mx.aol.com (rly-ip01.mx.aol.com [205.188.156.49]) by hub.freebsd.org (Postfix) with ESMTP id 73BC437C216 for <freebsd-doc@FreeBSD.ORG>; Thu, 29 Jun 2000 15:59:31 -0700 (PDT) (envelope-from ledermin@reboot.cx) Received: from tot-tj.proxy.aol.com (tot-tj.proxy.aol.com [152.163.213.131]) by rly-ip01.mx.aol.com (8.8.8/8.8.8/AOL-5.0.0) with ESMTP id SAA16125 for <freebsd-doc@FreeBSD.ORG>; Thu, 29 Jun 2000 18:59:27 -0400 (EDT) Received: from frogger (98AF0C90.ipt.aol.com [152.175.12.144]) by tot-tj.proxy.aol.com (8.10.0/8.10.0) with SMTP id e5TMxIb11892 for <freebsd-doc@FreeBSD.ORG>; Thu, 29 Jun 2000 18:59:20 -0400 (EDT) Message-ID: <000f01bfe236$81dcb620$090a0a0a@frogger> From: "Terry Motto" <ledermin@reboot.cx> To: <freebsd-doc@FreeBSD.ORG> Subject: 4.0-release to 4.0-stable has no tarball or iso from which to update from :( Date: Thu, 29 Jun 2000 18:48:34 -0700 MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_NextPart_000_0007_01BFE1FA.A0A4ED20" X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2615.200 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2615.200 X-Apparently-From: Nimredel@aol.com Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This is a multi-part message in MIME format. ------=_NextPart_000_0007_01BFE1FA.A0A4ED20 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable I am aware of programs like cvsup and such. My problem is that my bsd = box isn't connected directly to the internet and it's 4-releast. I would = ever so much update it to 4-stable but i cannot find a way to. I've = asked numerous times in the Efnet #Freebsdhelp channel what the = equivalent of cvsup'ing for the 4-stable so i'm not left out if i do = have to download each individual file from my slow modem :( I've noticed = a couple previous releases have tarballs of the update, but alas theire = is none for 4.0-stable nor a 4.0-stable iso... I know "stable" is a ever = changing thing but it would mean so much if i could just download a = tarball or the cvsup equiv of all the distributions... please! I use = Freebsd on my webserver and i want to use it on my local network as = well...=20 Terry M. Motto ------=_NextPart_000_0007_01BFE1FA.A0A4ED20 Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML><HEAD> <META content=3D"text/html; charset=3Diso-8859-1" = http-equiv=3DContent-Type> <META content=3D"MSHTML 5.00.2722.2800" name=3DGENERATOR> <STYLE></STYLE> </HEAD> <BODY bgColor=3D#fffcf0> <DIV><FONT color=3D#000000 size=3D2>I am aware of programs like cvsup = and such. My=20 problem is that my bsd box isn't connected directly to the internet and = it's=20 4-releast. I would ever so much update it to 4-stable but i cannot find = a way=20 to. I've asked numerous times in the Efnet #Freebsdhelp channel what the = equivalent of cvsup'ing for the 4-stable so i'm not left out if i do = have to=20 download each individual file from my slow modem :( I've noticed a = couple=20 previous releases have tarballs of the update, but alas theire is none = for=20 4.0-stable nor a 4.0-stable iso... I know "stable" is a ever changing = thing but=20 it would mean so much if i could just download a tarball or the cvsup = equiv of=20 all the distributions... please! I use Freebsd on my webserver and i = want to use=20 it on my local network as well... </FONT></DIV> <DIV> </DIV> <DIV><FONT color=3D#000000 size=3D2>Terry M. = Motto</FONT></DIV></BODY></HTML> ------=_NextPart_000_0007_01BFE1FA.A0A4ED20-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 16:38:37 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 9AE2D37C12F; Thu, 29 Jun 2000 16:38:26 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id RAA88065; Thu, 29 Jun 2000 17:38:24 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id RAA37275; Thu, 29 Jun 2000 17:38:17 -0600 (MDT) Message-Id: <200006292338.RAA37275@harmony.village.org> To: "Thomas M. Sommers" <tms2@mail.ptd.net> Subject: Re: XML driver config file to replace LINT Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Thu, 29 Jun 2000 14:37:22 EDT." <395B9762.5B95A329@mail.ptd.net> References: <395B9762.5B95A329@mail.ptd.net> <395A1950.50ECD8D5@mail.ptd.net> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <200006290019.SAA59924@harmony.village.org> Date: Thu, 29 Jun 2000 17:38:17 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <395B9762.5B95A329@mail.ptd.net> "Thomas M. Sommers" writes: : I was thinking of something analogous to the way syscalls.master is used : to generate several files. This works well for syscalls.master, but I don't think it would work well in the driver area. Call me crazy. However, I'll take an open and honest look at anything people come up with in this area. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 17:38:39 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout1.silyn-tek.de (mout1.silyn-tek.de [194.25.165.69]) by hub.freebsd.org (Postfix) with ESMTP id 0602E37B507; Thu, 29 Jun 2000 17:38:32 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.34] (helo=mx2.silyn-tek.de) by mout1.silyn-tek.de with esmtp (Exim 3.13 #1) id 137opC-0003aD-00; Fri, 30 Jun 2000 02:38:30 +0200 Received: from p3e9c110e.dip0.t-ipconnect.de ([62.156.17.14] helo=neutron.cichlids.com) by mx2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137opA-0000Ol-00; Fri, 30 Jun 2000 02:38:28 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id 870DAAC27; Fri, 30 Jun 2000 02:38:45 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id 6853A14A67; Fri, 30 Jun 2000 02:38:27 +0200 (CEST) Date: Fri, 30 Jun 2000 02:38:27 +0200 From: Alexander Langer <alex@big.endian.de> To: Warner Losh <imp@village.org> Cc: committers@FreeBSD.ORG, doc@FreeBSD.ORG Subject: Re: NOTES reorganization Message-ID: <20000630023827.C3070@cichlids.cichlids.com> References: <20000629184650.A14852@cichlids.cichlids.com> <200006291933.NAA35699@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <200006291933.NAA35699@harmony.village.org>; from imp@village.org on Thu, Jun 29, 2000 at 01:33:14PM -0600 X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thus spake Warner Losh (imp@village.org): > : Move NIC/SCSI stuff, which were the only split sections, behind these > : stuff. Describe all drivers only one time and list all supported > : chips. > For pccard (and eventually cardbus), I'd like to see all supported > pccards as well. I can help with that, and I think the nomads would > also like to see this. PAO had a wonderful database of card support, > and I'd like to see that merged into regular FreeBSD as well. That would be fine! Shall we do this in later steps or integrate this to my current patches? Unfortunately, NOTES (LINT) is ``well-committed'' :) Alex -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 17:41: 4 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 3E26737B5B0; Thu, 29 Jun 2000 17:40:58 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA88319; Thu, 29 Jun 2000 18:40:55 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA37780; Thu, 29 Jun 2000 18:40:54 -0600 (MDT) Message-Id: <200006300040.SAA37780@harmony.village.org> To: Alexander Langer <alex@big.endian.de> Subject: Re: NOTES reorganization Cc: committers@FreeBSD.org, doc@FreeBSD.org In-reply-to: Your message of "Fri, 30 Jun 2000 02:38:27 +0200." <20000630023827.C3070@cichlids.cichlids.com> References: <20000630023827.C3070@cichlids.cichlids.com> <20000629184650.A14852@cichlids.cichlids.com> <200006291933.NAA35699@harmony.village.org> Date: Thu, 29 Jun 2000 18:40:54 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000630023827.C3070@cichlids.cichlids.com> Alexander Langer writes: : Shall we do this in later steps or integrate this to my current : patches? : : Unfortunately, NOTES (LINT) is ``well-committed'' :) You do realize that we're likely talking about listing 200 or more different cards, right? Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 18: 2:40 2000 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 7E54B37B686; Thu, 29 Jun 2000 18:02:24 -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 BAA41133; Fri, 30 Jun 2000 01:42:11 +0100 (BST) (envelope-from nik) Date: Fri, 30 Jun 2000 01:42:10 +0100 From: Nik Clayton <nik@freebsd.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: Nik Clayton <nik@FreeBSD.org>, doc@FreeBSD.org, committers@FreeBSD.org, dgl@bsdi.com, jim@cdrom.com, papowell@astart.com, wpaul@FreeBSD.org, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: The website Message-ID: <20000630014210.A35224@catkin.nothing-going-on.org> References: <20000625200029.I470@kilt.nothing-going-on.org> <17146.962016763@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="qMm9M+Fa2AknHoGS" Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <17146.962016763@critter.freebsd.dk>; from phk@critter.freebsd.dk on Mon, Jun 26, 2000 at 12:52:43PM +0200 Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --qMm9M+Fa2AknHoGS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Mon, Jun 26, 2000 at 12:52:43PM +0200, Poul-Henning Kamp wrote: > * Other topic for dynamic content: HTML'ed page with the last 24h > of commit logs, ie: pointers into cvsweb to see the diffs. Here's the beginnings of something that could mutate in to this. Simply iterate over each non-.gz file in the commitlogs directory, pulling out the timestamp (which is on the first line of each commit message), the filename involved, and the tell() position within the file for future reference. Sort the list of timestamps in reverse chronological order. Then, for the top three (i.e., the most recent three commits) re-open the file, seek back to the right position for the appropriate commit message, and then display the log message. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery --qMm9M+Fa2AknHoGS Content-Type: application/x-perl Content-Disposition: attachment; filename="commit.pl" #!/usr/bin/perl -w # # Scan through the commit logs, shows the last three commits use strict; use IO::Seekable; # SEEK_* constants my $logdir = "/home/ncvs/CVSROOT/commitlogs"; my @logs = (); # Commitlog filenames my %commits = (); # Commit map my $log = ''; # Current commitlog filename my $tstamp = ''; # Timstamp my $max_hist = 3; # How far back to go my $cur_hist = 1; # How far back have we gone? # Get a list of all the files in $logdir that only contain [a-z]. This # gets rid of all the .gz files. opendir(D, $logdir); @logs = grep { /^[a-z]+$/ && -f "$logdir/$_" } readdir(D); closedir(D); # Iterate over all the logs, storing the timestamps of each commit, along # with their position in the log and the file involved. foreach $log (@logs) { open(L, "<$logdir/$log") or die "Can't open $log: $!\n"; while(<L>) { next if $_ !~ /^[a-z]/; # Skip non-header lines chomp; # It's a header line, pull out the timestamp, and store the # filename and current file position as a ref-to-array in the # hash. (undef, $tstamp) = split(/\s+/, $_, 2); $commits{$tstamp} = [ $log, tell(L) ]; } close(L); } foreach $tstamp (reverse sort keys %commits) { last if $cur_hist > $max_hist; # Only print $max_hist entries open(L, "<$logdir/$commits{$tstamp}[0]") or die "Can't open $commits{$tstamp}[0]_: $!\n"; seek(L, $commits{$tstamp}[1], SEEK_SET); # Print out the log message print "$tstamp\n"; while(<L>) { last if $_ =~ /^[a-z]/; # Encountered a new header line # so stop what we're doing print $_; # Print this line } close(L); $cur_hist++; } --qMm9M+Fa2AknHoGS-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 19:51:36 2000 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 60B2B37B68D for <doc@freebsd.org>; Thu, 29 Jun 2000 19:51: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 DAA63484 for doc@freebsd.org; Fri, 30 Jun 2000 03:50:14 +0100 (BST) (envelope-from nik) Date: Fri, 30 Jun 2000 03:50:12 +0100 From: Nik Clayton <nik@freebsd.org> To: doc@freebsd.org Subject: On embedding 'library' graphics into documentation Message-ID: <20000630035012.A41595@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="h31gzZEtNLTqOjlF" Content-Disposition: inline User-Agent: Mutt/1.2i Organization: FreeBSD Project <URL:http://www.freebsd.org/> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: inline How are we going to handle images that recur throughout different documents? [ It has come to my attention that apparently some of my messages have attracted a fan following, due to their extreme length. If that's the sort of thing you like then you'll love this. ] This gets a little bit complicated. As well as images that are document specific (screenshots, diagrams, and so on) we're going to have some images that will be re-used across the documents. For example, a picture of beastie holding up an exclamation mark next to "<warning>" elements, that sort of thing. And, of particular relevance to what I'm doing right now, "callout bugs". A "callout bug" is a little indicator next to a piece of text that you can refer to later on when you want the reader to understand exactly which bit of the text you're referring to. For example, mv [1]source-file [2]destination-file where [1] and [2] are my (rather crude) implementation of what a callout bug could look like. Later on in the text you might say. [1] The source file name. The mv command renames the file currently called source-file, which must exist when mv is executed. [2] The new filename. The mv command changes the name of the old file to destination file. If destination file exists when mv is executed it will be replaced by the old file. A real world example of where we use this is in the Handbook, in the section on PPP configuration. In there we use line numbers, but callout bugs would be equally appropriate. In particular, line numbers don't work where you want to refer to more than one thing on the same line, and breaking the line is impractical. I actually need to do this *now*, because I'm writing up an appendix to the DocProj Primer that includes various command lines you can run to do various things to the documentation, and I need to be able to refer back to portions of the command line in the following text. For more information, go to http://www.docbook.org/, read the online copy of The Definitive Guide, and the section relating to the <callout> element. You can do this without images -- putting (define %callout-graphics% #f) in the stylesheet does it for you. In this case your callouts are flagged much as I've done above, with [1], [2], and so on. This is OK, but not great. For one thing, it looks too much like the way footnotes are flagged. For another, the callouts are not visually distinct from the rest of the line -- you don't want a naive reader assuming that these are part of the command line you want them to type in. For these reasons (plus the fact we're going to have to confront this issue sooner or later when we put in admonition graphics and such like) I've started looking at how we share the same images across different documents. I've come to the conclusion that, at install time, we can't. That is to say, each document is independent from one another. I don't want one document to have to depend on another document for its images. Nor do I want to make each piece of documentation depend on another package that just contains the common image library. There are also issues relating to the position of the files in the image library. At the moment, someone could pkg_add a hypothetical image library package with $PREFIX set to something, and then pkg_add the Handbook with $PREFIX set to something else. Short of a post-installation script which attempted to find the image library and fix up the links in the document this is impossible to resolve. And a post-installation script would rapidly become a twisty maze of conditionals and special cases as it tried to work out where the image library had been installed. So, unfortunately, each document is going to have to carry its own copy of the imagelibrary (or rather, those parts of the image library that it uses) with it. This will bloat the installation area as soon as a reader installs more than one document, but (1) I don't see a way around that, and (2) the bloat is minimal. This is *not* to say that we can't have a common image library in the CVS tree, just that we can't rely on having a common image library for the installed documentation to use. However, at build, installation, and packaging time, each document will have to copy those images from the library that it uses to its own directory. Having decided to do that, things become somewhat simpler. Attached are a variety of patches and related files for inspection which do just that. 1. imagelib.tar.gz should be extracted in the en_US.ISO_8859-1 directory. This should give you an imagelib/ directory at the same level as the books/ and articles/ directories. It contains one sub-directory, for the callout bugs, and 10 PNG files. 2. co-test.tar.gz should be extracted in the en_US.ISO_8859-1/articles directory. You should get a co-test/ directory, with a Makefile and an article.sgml. 3. doc.imagelib.mk should be copied into the doc/share/mk subdirectory. 4. doc.docbook.mk.diff should be applied. I'll walk through these changes in a minute. 5. doc.project.mk.diff should be applied. 6. freebsd.dsl.diff should be applied (in doc/share/sgml). This includes a few changes that are not related to this -- you can ignore them, it's just stuff I'm testing in my tree, and doesn't affect this. In particular, only the callout-* stuff is used, you can ignore the rest. 7. freebsd.dtd.diff should be applied. This fixes a shortcoming in DocBook where callouts aren't allowed inside <userinput>. I'll be submitting an RFE (Request for Enhancement) about this shortly. That should be sufficient for you to go in to the co-test directory and run make(1) to generate all the different output formats you want. Now, about those changes to doc.docbook.mk. . . We define and implements a new format, "html.tar". Previously, we've special-cased the html-split format, as we knew it would generate multiple files that would need to be managed. It was assumed that the other formats would only ever generate one output format. This is now not the case, as the bare "html" format still needs to be able to carry around all the images it will need to display properly. So the html.tar format is designed to do that. We also update the html-split.tar (and the new html.tar) format to ensure that tar is called to include the files listed in the IMAGELIB variable as necessary. We have to list the imagelib files as being dependencies for the various HTML output formats -- this ensures that if they don't exist, the simple rules in doc.imagelib.mk will copy them in to the current directory. The install rule is a bit more complicated, as we need to ensure that images are installed in to the correct subdirectory as necessary. And when building packages we need to ensure that the list of images is added to the PLIST. What about images for other languages? I don't think this will be a big problem. Some images will almost certainly contain text, or other content that will need to be translated. The easiest way to handle this would be a mechanism in doc.imagelib.mk that looks for the images first in the language specific imagelib/ directory (I assume each language will have one), and if it can't find it there then it copies it from the English imagelib/ directory. I'd do this now, but it's 3.50am, and I need to be up in about 4 hours time. . . Thoughts? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery --h31gzZEtNLTqOjlF Content-Type: application/x-tar-gz Content-Disposition: attachment; filename="co-test.tar.gz" Content-Transfer-Encoding: base64 H4sICFUEXDkCA2NvLXRlc3QudGFyAO1XbW/bNhDO1+hX3NJi2LBEtPPmD1O8JXbSenBeEDvF CgwoaImOmUikR1JJg6L/fXeSKCtb0zUfWmCYDg4i8Y7He+Nzp1hvOWEdW/uKBLud3t4erAF0 e3vd5n9PHYBed7vX6Wx3u/jc7XR7u2uwt/YNKLeOG4A1JW8/K/dv/P8oxVX+T/mtmMtUfI0z up3O/u7uk/nvdrZ3fP67vZ1dXMH0d9ag0+b/q1Nwejg6m+Lf8eUBuvjriRHiaDIMtbkOguH5 4JcD4MbJOBVBcHJ+eXo4neDSwmVpEIzOJtPD8fjd4Pz04vJ4MjkeIqtePT8bv33ECoIXgL/J 5WACqbTOglsIkCqRdzLJeQqTV6djoCIkDneQYU1CvizEEh3nmVAuhMGCq2thUZPTwNUD6DlJ WFFtvZdpCnNtYgEcjJjlMk2CF3R4oT/WyqGegMw4AO9caK+zFEholHHUDnOjs+Lg2Ghrt/zx IImN5s8MNw/B6PTw1fF4dHSwHvM01bmzrBsu1XXN+KnB2X6Ss/MkZ/dJzl7BoRS9wwifjH7H 2L/8EA6uLoejy48sDMtfEIRSxWmeCNh4+WEl/ZHZBTeCZbcMfQuXRt+I2IXZ7Uaw1tL/hzz+ N+/BN8b/3f29/Rr/93vYC7rb+zst/n8Tir5DTJi+vTj2SAgXV0fj0QA2thirmgFjw+kQhjo+ 0voW3uyE3a0jbkUCx+8RSq3UirHjs41+QNkMokoRvdLzQvBEmJIZOemQc6hAvOfZEk+rhCNW cmgPa2yid4vA1H20f6CzjKvE1rtK5pIb3p8upAXagmYBtxZhu2onDzqHBb+jloM5T1N0gADe 6rm7RygsehKuSRWUdUnMiHqK4pnoO/HeIUrGBJeElhGrWbDUxm2CkLjDwOwBT1HJJmh6rnTl VqrrQiPJhgAnOTlpNkFiT7GVoUltqFmZhdza4EqbVGDzWSINuqmNRAdzheFqWMtya1iqsVuw hqGb2C8Lpys9XsMD3KMtAmZS8UJdEaaZEKoRq8KOwrZqdyTUHTf9i8Pp64iVz+jYYXKDV6p0 lbsFuQZKxMJabJjUl5sq7AOGPAsjVqSuSiMlb7vvDykzfFXE7zcsisc5JyvKSuoH63V1qDuB ZYUbfM3ipPB6is3/B60wz9xcl8PCj7WyddxtYyx31f8es5stXZhbYX6GiP5Jtcxd/wZPh603 oHS8yNWthT/w9FiDTA42/Fp1CbZiaGSg7LSErFQ8MzSIJdbalGU6ydEaFnOMsb5GhV5ftfKl 6moFnxcnD/4umzzLUhr8PCtMbFobXIh5cx0U45TnOcOVxcxnFZ9CXw5c/fKZtNbSvlo3+hFb BT9iVXoCzFQ1BNGFxdRRFsoFRBOBv7l9lJD1FThMliKWcynK0TNKpROGp30vHDG/AiSeCXyh 2qEbs15VrHvAIXMhhLObxZRJZYanAx6PdpL0TMC9kQ6hEd/8vojPZkbc9SfT4fnVFDGufK1L n7xglRvk4yedWlXFkz5VIhXk0YUpB2IlCF00EIThXQy9XdMFRnW1iwDHiD9zBIYkJC5dFGNL jPJihW6vgOZpjiiB4EAp5iXuzshwsmc4mUzGzahVWvGSa5V8qZLqGmMbqra7hTRJvc2rae62 ZVhicprC8LxI+3J+Ms7zHINKAFfVxz8cXSXAW1fkASuawFb5RPi2UH/fPMvM5s1qmDpC0DZ5 jF9YRQFQ2oUhMeB1PYpsueBW2n6to4gbIrlnlN9AhJjU/ouPLU09C1MwUuAVOeq3MY4Dm9Xn HN0CXJqJwjWvHKuv/qRqpLPWUgaxAGnK8rOisEKMz+QLZRp3wi50niY+CWVfxJIv+mFdTqsr XcwJlb6k0WYL5GpOAgWcfdr49fq5xK0qD6zuX+Vr3f3KRxx8IlZPVO33SksttdRSSy211FJL LbXUUksttdRSSy219OX0F0J8mR8AKAAA --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc.docbook.mk.diff" Index: doc.docbook.mk =================================================================== RCS file: /home/ncvs/doc/share/mk/doc.docbook.mk,v retrieving revision 1.11 diff -u -r1.11 doc.docbook.mk --- doc.docbook.mk 2000/04/29 07:46:15 1.11 +++ doc.docbook.mk 2000/06/30 02:41:50 @@ -51,15 +51,18 @@ DSLHTML?= ${.CURDIR}/../../share/sgml/freebsd.dsl DSLPRINT?= ${.CURDIR}/../../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 +IMAGELIB?= + 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 pdb +KNOWN_FORMATS= html html.tar html-split html-split.tar txt rtf ps pdf tex dvi tar pdb # ------------------------------------------------------------------------ # @@ -115,6 +118,9 @@ .elif ${_cf} == "html" _docs+= ${DOC}.html CLEANFILES+= ${DOC}.html +.elif ${_cf} == "html.tar" +_docs+= ${DOC}.html.tar +CLEANFILES+= ${DOC}.html ${DOC}.html.tar .elif ${_cf} == "txt" _docs+= ${DOC}.txt CLEANFILES+= ${DOC}.html ${DOC}.txt @@ -166,13 +172,13 @@ all: ${_docs} -index.html HTML.manifest: ${SRCS} +index.html HTML.manifest: ${SRCS} ${IMAGELIB} ${JADE} -V html-manifest -ioutput.html ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} .if !defined(NO_TIDY) -tidy -i -m -f /dev/null ${TIDYFLAGS} `xargs < HTML.manifest` .endif -${DOC}.html: ${SRCS} +${DOC}.html: ${SRCS} ${IMAGELIB} ${JADE} -ioutput.html -V nochunks ${JADEOPTS} -d ${DSLHTML} -t sgml ${MASTERDOC} > ${.TARGET} .if !defined(NO_TIDY) -tidy -i -m -f /dev/null ${TIDYFLAGS} ${.TARGET} @@ -180,6 +186,11 @@ ${DOC}.html-split.tar: HTML.manifest tar cf ${.TARGET} `xargs < HTML.manifest` + tar uf ${.TARGET} ${IMAGELIB} + +${DOC}.html.tar: ${DOC}.html + tar cf ${.TARGET} ${DOC}.html + tar uf ${.TARGET} ${IMAGELIB} ${DOC}.txt: ${DOC}.html w3m -S -dump ${.ALLSRC} > ${.TARGET} @@ -193,9 +204,6 @@ ${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} @@ -270,7 +278,7 @@ .for _curformat in ${KNOWN_FORMATS} _cf=${_curformat} .for _curcompress in ${KNOWN_COMPRESS} -.if ${_cf} == "html-split" +.if ${_cf} == "html-split" || ${_cf} == "html" ${DOC}.${_cf}.tar.${_curcompress}: ${DOC}.${_cf}.tar _PROG_COMPRESS_${_curcompress} .else ${DOC}.${_cf}.${_curcompress}: ${DOC}.${_cf} _PROG_COMPRESS_${_curcompress} @@ -283,8 +291,7 @@ # Install targets # # Build install-* targets, one per allowed value in FORMATS. Need to -# build -# two specific targets; +# build two specific targets; # # install-html-split - Handles multiple .html files being generated # from one source. Uses the HTML.manifest file @@ -320,12 +327,21 @@ @if [ -f ${.OBJDIR}/${DOC}.ln ]; then \ (cd ${DESTDIR}; sh ${.OBJDIR}/${DOC}.ln); \ fi - +.for _curimage in ${IMAGELIB} + ${INSTALL_DOCS} ${_curimage} ${DESTDIR}/${_curimage:H} +.endfor .for _compressext in ${KNOWN_COMPRESS} install-${_cf}.tar.${_compressext}: ${DOC}.${_cf}.tar.${_compressext} @[ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} ${INSTALL_DOCS} ${.ALLSRC} ${DESTDIR} .endfor +.elif ${_cf} == "html" +install-${_cf}: ${DOC}.${_cf} + @[ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} + ${INSTALL_DOCS} ${.ALLSRC} ${DESTDIR} +.for _curimage in ${IMAGELIB} + ${INSTALL_DOCS} ${_curimage} ${DESTDIR}/${_curimage:H} +.endfor .else install-${_cf}: ${DOC}.${_cf} @[ -d ${DESTDIR} ] || mkdir -p ${DESTDIR} @@ -370,6 +386,9 @@ @cp HTML.manifest PLIST .else @echo ${DOC}.${_curformat} > PLIST + @for imagelib in ${IMAGELIB}; do \ + echo $$imagelib >> PLIST; \ + done .endif @pkg_create -v -c -"FDP ${.CURDIR:T} ${_curformat} package" \ -d -"FDP ${.CURDIR:T} ${_curformat} package" -f PLIST \ --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc.imagelib.mk" # # $FreeBSD$ # # This include file <doc.imagelib.mk> handles pulling in images from the # imagelib/ directory as necessary. # # Each document that wants to use one or more images from imagelib/ has to # list them in the IMAGELIB variable. For example, a document that wants to # use callouts 1 thru 4 has to list # # IMAGELIB= callouts/1.png callouts/2.png callouts/3.png callouts/4.png # # in the controlling Makefile. # # This code ensures they exist in the current directory, and copies them in # as necessary. # IMAGELIB_DIR?= ${.CURDIR}/../../imagelib CP?= /bin/cp MKDIR?= /bin/mkdir .for _curimage in ${IMAGELIB} ${_curimage}: ${IMAGELIB_DIR}/${_curimage} [ -d ${_curimage} ] || ${MKDIR} -p ${_curimage:H} ${CP} ${IMAGELIB_DIR}/${_curimage} ${_curimage} .endfor --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc.project.mk.diff" Index: doc.project.mk =================================================================== RCS file: /home/ncvs/doc/share/mk/doc.project.mk,v retrieving revision 1.2 diff -u -r1.2 doc.project.mk --- doc.project.mk 1999/09/06 06:53:39 1.2 +++ doc.project.mk 2000/06/30 02:26:06 @@ -67,8 +67,13 @@ .if ${DOCFORMAT} == "docbook" .include "doc.docbook.mk" .endif +.if ${DOCFORMAT} == "html" +.include "doc.html.mk" .endif +.endif # Subdirectory glue and ownership information. .include "doc.subdir.mk" .include "doc.install.mk" +.include "doc.imagelib.mk" + --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="freebsd.dsl.diff" Index: freebsd.dsl =================================================================== RCS file: /home/ncvs/doc/share/sgml/freebsd.dsl,v retrieving revision 1.14 diff -u -r1.14 freebsd.dsl --- freebsd.dsl 2000/03/23 09:00:16 1.14 +++ freebsd.dsl 2000/06/30 01:36:35 @@ -1,4 +1,4 @@ -<!-- $FreeBSD: doc/share/sgml/freebsd.dsl,v 1.14 2000/03/23 09:00:16 nik Exp $ --> +<!-- $FreeBSD: doc/share/sgml/freebsd.dsl,v 1.13 2000/02/15 01:57:17 nik Exp $ --> <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ <!ENTITY % output.html "IGNORE"> @@ -45,6 +45,48 @@ ;; Write a manifest? #f) + (define %callout-graphics% + ;; Use graphics in callouts? + #t) + + (define %callout-graphics-ext% + ;; The extension to use for callout images. This is an extension + ;; to the stylesheets, they do not support this functionality + ;; natively. + ".png") + + (define %callout-graphics-path% + ;; Path to callout graphics + "./callouts/") + + ;; Redefine $callout-bug$ to support the %callout-graphic-ext% + ;; variable. + (define ($callout-bug$ conumber) + (let ((number (if conumber (format-number conumber "1") "0"))) + (if conumber + (if %callout-graphics% + (if (<= conumber %callout-graphics-number-limit%) + (make empty-element gi: "IMG" + attributes: (list (list "SRC" + (root-rel-path + (string-append + %callout-graphics-path% + number + %callout-graphics-ext%))) + (list "HSPACE" "0") + (list "VSPACE" "0") + (list "BORDER" "0") + (list "ALT" + (string-append + "(" number ")")))) + (make element gi: "B" + (literal "(" (format-number conumber "1") ")"))) + (make element gi: "B" + (literal "(" (format-number conumber "1") ")"))) + (make element gi: "B" + (literal "(??)"))))) + + <!-- Understand <segmentedlist> and related elements. Simpleminded, and only works for the HTML output. --> @@ -124,7 +166,23 @@ (normalize "legalnotice") (normalize "abstract"))) - + <!-- The stylesheets need to know about the graphic formats we + use. In particular, PNG isn't supported "out of the box." --> + (define %graphic-extensions% + '("jpg" "png" "tex" "gif")) + + (define %graphic-default-extension% + "png") + + (define preferred-mediaobject-extensions + (list "tex" "jpg" "jpeg" "png")) + + (define acceptable-mediaobject-extensions + (list "gif" "bmp")) + + (define acceptable-mediaobject-notations + (list "GIF" "GIF87a" "GIF89a" "BMP")) + <!-- Slightly deeper customisations --> <!-- I want things marked up with 'sgmltag' eg., @@ -151,8 +209,10 @@ Configure the stylesheet to behave more like John's. --> (element command ($mono-seq$)) + + (element application ($italic-seq$)) - (element application ($bold-seq$)) + (element filename ($italic-seq$)) <!-- Warnings and cautions are put in boxed tables to make them stand out. The same effect can be better achieved using CSS or similar, @@ -182,13 +242,15 @@ <!-- Default to labelling Q/A with Q: and A: --> +<!-- (define (qanda-defaultlabel) (normalize "qanda")) +--> <!-- For the HTML version, display the questions in a bigger, bolder font. --> - <![ %output.html [ + <![ IGNORE [ (element question (let* ((chlist (children (current-node))) (firstch (node-list-first chlist)) --h31gzZEtNLTqOjlF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="freebsd.dtd.diff" Index: freebsd.dtd =================================================================== RCS file: /home/ncvs/doc/share/sgml/freebsd.dtd,v retrieving revision 1.4 diff -u -r1.4 freebsd.dtd --- freebsd.dtd 2000/02/14 01:30:48 1.4 +++ freebsd.dtd 2000/06/29 19:28:24 @@ -23,12 +23,10 @@ <!-- ..................................................................... --> <!-- Entities for element classes and mixtures ........................... --> -<!-- Object-level classes ................................................ --> - -<!ENTITY % local.list.class "|FAQList"> - <!-- Character level classes --> <!ENTITY % local.tech.char.class "|HostID|Username|Devicename|MakeTarget|MakeVar"> + +<!ENTITY % local.cptr.char.mix "|CO"> <!-- OS Version attributes ............................................... --h31gzZEtNLTqOjlF Content-Type: application/x-tar-gz Content-Disposition: attachment; filename="imagelib.tar.gz" Content-Transfer-Encoding: base64 H4sICM4BXDkCA2ltYWdlbGliLnRhcgDtmXtQk1cWwKNgxBhAIgEJPkIBHw0l3/thW0FAAUVE QcT1xfcKgrwUUFlUlAJCUVYUxCqtKKhVQRHF8lAB6XZRcKWuo+KrqKwovqgKoti1oepMd+Ju /2kDZe5vJnMzczP3m8nJ75xzT4LDmCAhNJhVi/44lBhE4rhSpFTCJA7/en0HpFSSMEKQBEli hHYbwhBSpMRFeiAmKppZqlSKwoMX/9/P/db+n5Tgd/HnmNDQiJjoKHVPxp/sjrx2G0FQHMS/ Z+IPO0aGB/2uz4AhiMCw/x1/rNv5d/FHYe02ChOISAmB+P/hpPp4uxtLFBLtW2NPD7eZ2lXa /TLq3owaafCxduE83Sb6rbgyK/2wcRVkZFiZ/0zhOO6EiyYv+h5hy28oqDbKNPTYNda8bUz+ 63UVZ7+/EnDHZLb4a4MCk8HGNHd44pppH9nwE4osobHnPsx1ahuYI1bXcquuXTw4ArdSxCSm frd+vGXVCgeLB9V+R7WP84ieFBDtG6GJXs4sFUTOY23HeXb/SKcxQcHcYiXuCDvCSghSQ4ga gpUzxsOEklsaHBUd6xwWGxUdzDkKUY58TGREeLQjFxFmMtWsVHvmh7+cGRwUzkTHaA8lWU4Q CJbhMBxlaJKCBJqFWJ7FNTyCaQh4T9q4rd1fgOckb7eDLoEJoj7Le/yHfu8E8Fv+45CO/whK Av97i/+fvfHfPn2n3NBmiKtthoeDLDXHwnvB4LmnjkXKUudV2K/PH2Ani5Ol1p89mdaljvV0 frKpaXeobN4tg3lPYhUpvtOOrPoh+HZ62v7Po3Y1DbgUk1O73qrf3XJTw7rXzIgU84D63Hil 1Oq5gdB5pbDq2rIXx9yPhVgnnbb5NI+Xt8ws+djp+i5Xtm7QYjP95AeK0CAYQ3EMrUEInOAp DuIYhiAoCoMYiNXU5Dx/0jfyg67/iP7rP/me+k8A/3uL/3Fv/B+h9b8Gkro5YZgD7mD+TDI/ r6ioQWUkTtYkFjSY9Z9qPHjArNPu+XHlz2NKr15c/LCi7LZv0w3nPZxLxZ3HvmauN0sXWfim bjTp/Mosf6Msbuh95G+xWzAz17CCqP4LOszL7JUNXdINbof2qsyn56VPGbcqbXy8XyMeuEMd n6cn73GUwEgaZTiYYjgK07A8QjIcDfNa+1mKO2R/eWXf6gt0/Ud7wH9U138M+N9b/F/xtv57 H5DXOEuHYs8Ua5MX7D4KFanMR0ofSAZWTA4M/JrJ3anaO3rLjX+Zzior2x9fLJGLl1gGmJ/P bVnySDJV2iTfVZLQIJofObS1evuStrodneil0Zmf3r1a+ZHtsOwX7Y/WpH/1he/4crY67MHM f1qNDrFueSWaUYpzr+5v8NKP/CxNQzRLoQiGMyzHYDAm8ByBMyhNaiiaxW+ViDb0uUuBrv+Y /v0nfl3/kV/8JyHgf2/xP+pt/d9gI0uCuvv/rABeEA75pH77Qca8vCd1Eao4+1Dh32eKbNiW E431hnZdI7lgk1y5CFaaWi65acy7LjdxTRj17G7YFJl/07Bqu7Q64vGimCzzHL9tIas/WVh4 qri5bGVd1Ysvnt7OOxovmbp/8slWMZE+t/V4jX7U5yiao1CaxwhaQAQcgwQME2hcW4YoFMVZ QXPvh/q+OQ/Q9R/vgfoP6/hP4MD/3uL/sjf+y9N3mn0LSQ1NJYpkhUKxf0B2W/swsSJZvFq1 0GVRbu7NnzxDg5Z1GG7KHvX3c9MSbl78S9jFUWtrrMwMwm4nV21cztqtjPe9tsSu/scFa+wv jLOX5WeZFt24YH53ePscKx8F2jEfKZzRGFIy3D57e/vKFlPbuaTaZWF8l35SgICTDMxwOCNg FINAAiOgGp7jKZLkCQhiaTvl8Gl9MAXo+k/o3X8cgnT8x8H8r9f4v+qt/9r6r73/G1pKLLaJ JeKXg9f+NJk56TMsICBk65hM8ctBO5MTEvbXh7eEd6SkPN1XXiJNjPAxb/WovRY6zyXG+3Kh +YE2m7QDwfLA3VVFN7oM+FPXza6OaX5wKbeyxaGmboswcnjnhdKgnd5e+/K9Hn9i/No/o70t xelIFNUqKbWeo580gGPaRgCGeJwiBJrGWBZlERbHaYHQQAiOoN9PtPboS2lA13+yB/p/XLf/ B///9Rr/l76b/xf2S4KkidP9P5hjU1xskVrwwCtr+kn5xqyCaokH35yhSvU42fzEYFPetofr NudeEowXnhnREOmWbVl8OzH0hHWb63bIT1V75oAq3/Tg2kGb5P4Tk0Oub879LG799Cy6MzRq lJf76XjP0389/rT/BAKudB/i76unmz+joRFt3ScFGuVhBtIwNAVRCMJAkMDRvFDgNetO32z/ 3+M/1QP1H9Ht/1Hgf2/xP/6/5v8DtP3/FoVYrL0DiJclnSpoMDuewATmXjKS4hjmt1tyz+l6 hdqv/Vp26ey5DRk2bpfLkwzby+YGfulXizaYjh2Wqdn449osy8j2Foshpo/LgipTuJLqxuFo NbzlcqUjVJI54fPSlwtbjxirZhXS3zU/fiXK20GXT2YfmugnGaAsx2GMQAsoQ5KUBoMgGucF QcMQAq5tBQSjzkkZfScZ6PpP9w7/wfy/t/kvT7exSNT67z7Zn82oneJQLCubHZDaLKld0G9O 2abFfqxKZXtk3+m4zU7qF1vnNGbHqkOS74ltqq6MkM0Mqfgys/8/VJtXKzc3dUwaYTY0xzbW WZy495sO66ZvhmRss7n1aE9UsdzxQtDh/yRNOjxy3cPz96efXSqVqQ89Hbjeh2Ibz3dZ6sd/ RsOgFAdRPEZqaz/DkgjJsbwGpjUoAlMIdXUKfq6PNgMAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAADgT8XPtfglWgBQAAA= --h31gzZEtNLTqOjlF-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 20: 8:54 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 2E7EF37B68D; Thu, 29 Jun 2000 20:08:49 -0700 (PDT) (envelope-from kuriyama@FreeBSD.org) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5U38oh58502; Fri, 30 Jun 2000 12:08:52 +0900 (JST) Date: Fri, 30 Jun 2000 12:08:50 +0900 Message-ID: <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama <kuriyama@FreeBSD.org> To: doc@FreeBSD.org, current@FreeBSD.org Subject: Re: XML driver config file to replace LINT In-Reply-To: In your message of "29 Jun 2000 16:01:36 GMT" <200006291558.JAA34002@harmony.village.org> References: <20000629144257.A23415@catkin.nothing-going-on.org> <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <200006290024.SAA59981@harmony.village.org> <200006291558.JAA34002@harmony.village.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org So, this is what I worried about. :-) At 29 Jun 2000 16:01:36 GMT, Warner Losh <imp@village.org> wrote: > I'd violently oppose this. I'd rather see the XML file generated from = > the .h files that we already use to build the system with. You would > be making it just as hard to keep things up to date with little gain > from the programmer's point of view. You need to make it easier for > the programmer to keep things up to date rather than harder. =46rom the documentation point of view, XML source file should be used to generate other "rendered" text such as *.c/*.h. In principle, using XML is same process such as using src/sys/dev/usb/usbdevs. As you know, generation of usbdevs{,_data}.h is done by awk script. And same procedure is done in src/sys/dev/pccarddevs for generating pccarddevs{,_data}.h. I think what Nik wants to say is, suggesting standard scheme to generate these files from human readable source file. And he suggests XML as that source file format. Of course, source tree are for programmers. First thing we should consider is not to stress programmers for that procedure. Nik's suggestion is more conceptual one. We need more discussion for this subject. # Nik, we should explain more about XML for freebsd-current people # before stepping forward. :-) -- = Jun Kuriyama <kuriyama@FreeBSD.org> // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Jun 29 20:39:33 2000 Delivered-To: freebsd-doc@freebsd.org Received: from khavrinen.lcs.mit.edu (khavrinen.lcs.mit.edu [18.24.4.193]) by hub.freebsd.org (Postfix) with ESMTP id A611937B555; Thu, 29 Jun 2000 20:39:29 -0700 (PDT) (envelope-from wollman@khavrinen.lcs.mit.edu) Received: (from wollman@localhost) by khavrinen.lcs.mit.edu (8.9.3/8.9.3) id XAA97675; Thu, 29 Jun 2000 23:39:29 -0400 (EDT) (envelope-from wollman) Date: Thu, 29 Jun 2000 23:39:29 -0400 (EDT) From: Garrett Wollman <wollman@khavrinen.lcs.mit.edu> Message-Id: <200006300339.XAA97675@khavrinen.lcs.mit.edu> To: Jun Kuriyama <kuriyama@FreeBSD.ORG> Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT In-Reply-To: <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> References: <20000629144257.A23415@catkin.nothing-going-on.org> <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <200006290024.SAA59981@harmony.village.org> <200006291558.JAA34002@harmony.village.org> <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org <<On Fri, 30 Jun 2000 12:08:50 +0900, Jun Kuriyama <kuriyama@FreeBSD.ORG> said: > using XML is same process such as using src/sys/dev/usb/usbdevs. As > you know, generation of usbdevs{,_data}.h is done by awk script. And > same procedure is done in src/sys/dev/pccarddevs for generating > pccarddevs{,_data}.h. Both of which are bugs imported from NetBSD. -GAWollman -- Garrett A. Wollman | O Siem / We are all family / O Siem / We're all the same wollman@lcs.mit.edu | O Siem / The fires of freedom Opinions not those of| Dance in the burning flame MIT, LCS, CRS, or NSA| - Susan Aglukark and Chad Irschick To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 1:56: 4 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id E676437B7C9; Fri, 30 Jun 2000 01:55:58 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 137wab-000KJM-00; Fri, 30 Jun 2000 10:55:57 +0200 Date: Fri, 30 Jun 2000 10:55:57 +0200 From: Neil Blakey-Milner <nbm@mithrandr.moria.org> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org Subject: Re: On embedding 'library' graphics into documentation Message-ID: <20000630105556.A77835@mithrandr.moria.org> References: <20000630035012.A41595@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000630035012.A41595@catkin.nothing-going-on.org>; from nik@freebsd.org on Fri, Jun 30, 2000 at 03:50:12AM +0100 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri 2000-06-30 (03:50), Nik Clayton wrote: > So, unfortunately, each document is going to have to carry its own copy of > the imagelibrary (or rather, those parts of the image library that it > uses) with it. This will bloat the installation area as soon as a reader > installs more than one document, but (1) I don't see a way around that, > and (2) the bloat is minimal. Yes, I agree that this is the best solution. It just keeps things simple for all cases. > Having decided to do that, things become somewhat simpler. Attached are > a variety of patches and related files for inspection which do just that. > > 1. imagelib.tar.gz should be extracted in the en_US.ISO_8859-1 > directory. This should give you an imagelib/ directory at the > same level as the books/ and articles/ directories. It contains > one sub-directory, for the callout bugs, and 10 PNG files. I would have thought that 'share' would be the place to put this, but I'd be happy with 'images'. 'share' also means I don't have to relearn my bad habits: "cvs co doc/{share,en_US.ISO_8859-1/{share,books/handbook}}" is my personal sin (: This applies even more if we have cross-language shared graphics too. share/images or even share/imagelib would be the more obvious to me. > I don't think this will be a big problem. Some images will almost certainly > contain text, or other content that will need to be translated. The easiest > way to handle this would be a mechanism in doc.imagelib.mk that looks for > the images first in the language specific imagelib/ directory (I assume > each language will have one), and if it can't find it there then it copies > it from the English imagelib/ directory. I'd do this now, but it's 3.50am, > and I need to be up in about 4 hours time. . . I prefer IMAGES to IMAGELIB for the variable name, since it makes more sense. We might want to have support for LOCAL_IMAGES too. LIB_IMAGES or LIBRARY_IMAGES are also alternatives. IMAGELIB sounds like you're chosing which image library you want to use. > IMAGELIB_DIR?= ${.CURDIR}/../../imagelib This could be replaced by: ${DOC_PREFIX}/${LANGCODE}/imagelib, much like our DSLHTML and DSLPRINT stuff will be soon (when I remember why it works for all cases). It could also possibly be multiple directories, but that'd require a bit more work. It might be an idea to make a variable ${LOCAL_SHARE} equal to ${DOC_PREFIX}/${LANGCODE}/share in the future. LANGCODEs one vice is that it resolves to '.' in external documents, and that means introducing another hack to remove it later. I'll have a quick write-up on how to do external documents with our wonderful build system in the next day or so. It may entail rewriting some stuff (like the auto-footer) to depend on the non-existance of "EXTERNAL_DOCUMENT" or similar, but it'll be way worth it. > .for _curimage in ${IMAGELIB} > ${_curimage}: ${IMAGELIB_DIR}/${_curimage} > [ -d ${_curimage} ] || ${MKDIR} -p ${_curimage:H} > ${CP} ${IMAGELIB_DIR}/${_curimage} ${_curimage} > .endfor Shouldn't this be: [ -d ${_curimage:H} ] || ${MKDIR} -p ${_curimage:H} ? > +.if ${DOCFORMAT} == "html" > +.include "doc.html.mk" > +.endif We should add this already. > + <!-- The stylesheets need to know about the graphic formats we > + use. In particular, PNG isn't supported "out of the box." --> > + (define %graphic-extensions% > + '("jpg" "png" "tex" "gif")) We need to add this already. Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 2: 8:15 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout2.silyn-tek.de (mout2.silyn-tek.de [194.25.165.70]) by hub.freebsd.org (Postfix) with ESMTP id E4B4037C3E2; Fri, 30 Jun 2000 02:08:10 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.33] (helo=mx1.silyn-tek.de) by mout2.silyn-tek.de with esmtp (Exim 3.13 #1) id 137wmM-0001gA-00; Fri, 30 Jun 2000 11:08:06 +0200 Received: from p3e9c115d.dip0.t-ipconnect.de ([62.156.17.93] helo=neutron.cichlids.com) by mx1.silyn-tek.de with esmtp (Exim 3.13 #1) id 137wmI-00079T-00; Fri, 30 Jun 2000 11:08:03 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id 4B655AC27; Fri, 30 Jun 2000 11:08:21 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id 449AE14A67; Fri, 30 Jun 2000 11:07:59 +0200 (CEST) Date: Fri, 30 Jun 2000 11:07:59 +0200 From: Alexander Langer <alex@big.endian.de> To: Warner Losh <imp@village.org> Cc: committers@FreeBSD.org, doc@FreeBSD.org Subject: Re: NOTES reorganization Message-ID: <20000630110759.A616@cichlids.cichlids.com> References: <20000630023827.C3070@cichlids.cichlids.com> <20000629184650.A14852@cichlids.cichlids.com> <200006291933.NAA35699@harmony.village.org> <20000630023827.C3070@cichlids.cichlids.com> <200006300040.SAA37780@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <200006300040.SAA37780@harmony.village.org>; from imp@village.org on Thu, Jun 29, 2000 at 06:40:54PM -0600 X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thus spake Warner Losh (imp@village.org): > : Shall we do this in later steps or integrate this to my current > : patches? > : Unfortunately, NOTES (LINT) is ``well-committed'' :) > You do realize that we're likely talking about listing 200 or more > different cards, right? Hmm. I just happened to vote for "merge in later" :) Alex -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 4:27: 4 2000 Delivered-To: freebsd-doc@freebsd.org Received: from smarthost-1.mail.telinco.net (smarthost-1.mail.telinco.net [212.1.128.90]) by hub.freebsd.org (Postfix) with ESMTP id A593137B97A for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 04:27:01 -0700 (PDT) (envelope-from harry_newton@telinco.co.uk) Received: from ppp-1-189.cvx4.telinco.net ([212.1.148.189] helo=chimaera.locus) by smarthost-1.mail.telinco.net with esmtp (Exim 3.02 #7) id 137ywl-000Bf2-00 for freebsd-doc@freebsd.org; Fri, 30 Jun 2000 12:26:59 +0100 Received: (from harry@localhost) by chimaera.locus (8.9.3/8.9.3) id MAA00316; Fri, 30 Jun 2000 12:20:09 +0100 (BST) (envelope-from harry@chimaera.locus) X-Authentication-Warning: chimaera.locus: harry set sender to harry@chimaera.locus using -f To: freebsd-doc@freebsd.org Subject: text justification in docbook X-Op.135: Muss es sein ? Es muss sein Organization: Gaudeamus From: Harry Newton <harry_newton@telinco.co.uk> Date: 30 Jun 2000 12:20:08 +0100 Message-ID: <86r99fv2jb.fsf@chimaera.locus> Lines: 9 User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.6 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Is it possible to specify that text be fully justified (i.e. flush left and right edges) when using Docbook/SGML ? I know it's possible in linuxdoc. Would you CC a copy of your reply back to me directly ? Cheers. -- Harry Newton harry_newton@telinco.co.uk To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 4:40: 8 2000 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 A227137C45F for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 04:40:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA95498; Fri, 30 Jun 2000 04:40:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id 9EC1A37C462; Fri, 30 Jun 2000 04:32:45 -0700 (PDT) Message-Id: <20000630113245.9EC1A37C462@hub.freebsd.org> Date: Fri, 30 Jun 2000 04:32:45 -0700 (PDT) From: dan@freebsddiary.org To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-1.0 Subject: docs/19600: include freshports upgrade announcement in newsflash Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19600 >Category: docs >Synopsis: include freshports upgrade announcement in newsflash >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: Fri Jun 30 04:40:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Dan Langille >Release: 4.0-stable >Organization: The FreeBSD Diary >Environment: >Description: http://FreshPorts.org/ has been upgrade to version 1.1 Let's tell the world. >How-To-Repeat: >Fix: $ diff -ruN newsflash.sgml newsflash.sgml.original --- newsflash.sgml Fri Jun 30 23:30:14 2000 +++ newsflash.sgml.original Fri Jun 30 23:23:25 2000 @@ -32,15 +32,6 @@ <h2>June 2000</h2> <ul> - <li><p><b>30-June-2000</b> - <a href="http://freshports.org/">http://freshports.org/</a> has - been upgraded to FreshPorts 1.1. The FreshPorts website contains - the latest details of which ports have been create/updated/removed. - This upgrade, the first since FreshPorts was release in early May, - gives you an improved home page, which together with a commit - history means you can find out about your ports faster and - easier.</p></li> - <li><p><b>26-June-2000</b> A new committer: <a href="mailto:akiyama@FreeBSD.org">Shunsuke Akiyama</a> (Optical disk driver)</p></li> >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 Jun 30 4:40:10 2000 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 C2F6137C465 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 04:40:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA95507; Fri, 30 Jun 2000 04:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13]) by hub.freebsd.org (Postfix) with ESMTP id 12E0D37C465 for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 Jun 2000 04:34:00 -0700 (PDT) (envelope-from ben@scientia.demon.co.uk) Received: from magnesium.scientia.demon.co.uk ([192.168.91.34] ident=exim) by scientia.demon.co.uk with esmtp (Exim 3.15 #1) id 137z37-000NJ7-00 for FreeBSD-gnats-submit@freebsd.org; Fri, 30 Jun 2000 12:33:33 +0100 Received: (from ben) by magnesium.scientia.demon.co.uk (Exim 3.15 #2) id 137z37-0009ex-00 for FreeBSD-gnats-submit@freebsd.org; Fri, 30 Jun 2000 12:33:33 +0100 Message-Id: <E137z37-0009ex-00@magnesium.scientia.demon.co.uk> Date: Fri, 30 Jun 2000 12:33:33 +0100 From: Ben Smithurst <ben@scientia.demon.co.uk> Reply-To: ben@scientia.demon.co.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19601: manpages wrongly installed to /usr/share/man (not in a subdirectory) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19601 >Category: docs >Synopsis: manpages wrongly installed to /usr/share/man (not in a subdirectory) >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 Jun 30 04:40:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Ben Smithurst >Release: FreeBSD 3.4-STABLE i386 >Organization: >Environment: -CURRENT >Description: The brooktree.4.gz and bt.4.gz are incorrectly linked into the /usr/share/man directory instead of keeping themselves to their subdirectories. This was caused by the move from man4.i386, when it was correct to link them into the ".." directory. Now they're just in man4, it's not. >How-To-Repeat: $ ls /usr/share/man >Fix: Index: Makefile =================================================================== RCS file: /usr/cvs/src/share/man/man4/Makefile,v retrieving revision 1.93 diff -u -r1.93 Makefile --- Makefile 2000/05/28 17:18:14 1.93 +++ Makefile 2000/06/30 11:30:31 @@ -19,8 +19,6 @@ vpo.4 vr.4 wb.4 wi.4 wx.4 worm.4 xl.4 xpt.4 yp.4 zero.4 MLINKS= bktr.4 brooktree.4 -MLINKS+=bktr.4 ../brooktree.4 -MLINKS+=bt.4 ../bt.4 MLINKS+=fd.4 stderr.4 fd.4 stdin.4 fd.4 stdout.4 MLINKS+=fpa.4 fea.4 MLINKS+=ipfirewall.4 ipacct.4 ipfirewall.4 ipaccounting.4 ipfirewall.4 ipfw.4 >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 Jun 30 4:50:56 2000 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 205D437C4DB; Fri, 30 Jun 2000 04:50:50 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Received: (from sheldonh@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id EAA97745; Fri, 30 Jun 2000 04:50:51 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Date: Fri, 30 Jun 2000 04:50:51 -0700 (PDT) From: <sheldonh@FreeBSD.org> Message-Id: <200006301150.EAA97745@freefall.freebsd.org> To: sheldonh@FreeBSD.org, freebsd-doc@freebsd.org, sheldonh@FreeBSD.org Subject: Re: docs/19601: manpages wrongly installed to /usr/share/man (not in a subdirectory) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: manpages wrongly installed to /usr/share/man (not in a subdirectory) Responsible-Changed-From-To: freebsd-doc->sheldonh Responsible-Changed-By: sheldonh Responsible-Changed-When: Fri Jun 30 04:50:14 PDT 2000 Responsible-Changed-Why: I'll do this. http://www.freebsd.org/cgi/query-pr.cgi?pr=19601 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 5: 2:52 2000 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 B00ED37B731; Fri, 30 Jun 2000 05:02:50 -0700 (PDT) (envelope-from nbm@FreeBSD.org) Received: (from nbm@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id FAA99088; Fri, 30 Jun 2000 05:02:50 -0700 (PDT) (envelope-from nbm@FreeBSD.org) Date: Fri, 30 Jun 2000 05:02:50 -0700 (PDT) From: <nbm@FreeBSD.org> Message-Id: <200006301202.FAA99088@freefall.freebsd.org> To: dan@freebsddiary.org, nbm@FreeBSD.org, freebsd-doc@freebsd.org Subject: Re: docs/19600: include freshports upgrade announcement in newsflash Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: include freshports upgrade announcement in newsflash State-Changed-From-To: open->closed State-Changed-By: nbm State-Changed-When: Fri Jun 30 05:02:22 PDT 2000 State-Changed-Why: Reversed patch applied, thanks! (: http://www.freebsd.org/cgi/query-pr.cgi?pr=19600 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 5:28:23 2000 Delivered-To: freebsd-doc@freebsd.org Received: from southpass.baynetworks.com (ns2.BayNetworks.COM [134.177.3.16]) by hub.freebsd.org (Postfix) with ESMTP id 421B537C4A7; Fri, 30 Jun 2000 05:28:19 -0700 (PDT) (envelope-from bwithrow@BayNetworks.COM) Received: from mailhost.BayNetworks.COM (h016b.s86b1.BayNetworks.COM [134.177.1.107]) by southpass.baynetworks.com (8.9.1/8.9.1) with ESMTP id FAA21269; Fri, 30 Jun 2000 05:20:04 -0700 (PDT) Received: from pobox.engeast.BayNetworks.COM (pobox.engeast.baynetworks.com [192.32.61.6]) by mailhost.BayNetworks.COM (8.9.1/8.8.8) with ESMTP id FAA20716; Fri, 30 Jun 2000 05:26:14 -0700 (PDT) Received: from baynetworks.com (kyzyl [192.32.150.103]) by pobox.engeast.BayNetworks.COM (SMI-8.6/BNET-97/04/24-S) with ESMTP id IAA09413; Fri, 30 Jun 2000 08:27:45 -0400 for Message-Id: <200006301227.IAA09413@pobox.engeast.BayNetworks.COM> X-Mailer: exmh version 2.1.1 10/15/1999 To: Garrett Wollman <wollman@khavrinen.lcs.mit.edu> Cc: Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT In-Reply-To: Message from Garrett Wollman <wollman@khavrinen.lcs.mit.edu> of "Thu, 29 Jun 2000 23:39:29 EDT." <200006300339.XAA97675@khavrinen.lcs.mit.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Fri, 30 Jun 2000 08:27:46 -0400 From: Robert Withrow <bwithrow@nortelnetworks.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org wollman@khavrinen.lcs.mit.edu said: :- Both of which are bugs imported from NetBSD. Obviously a matter of opinion. I think declarative DSLs for this kind of things are a good idea. But I understand some people want to do everything by hand in good-old C, and won't stop until it is ripped from their cold, dead fingers. ;-) -- Robert Withrow -- (+1 978 288 8256) BWithrow@BayNetworks.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 5:30: 7 2000 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 9C4F937C524 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 05:30:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id FAA03660; Fri, 30 Jun 2000 05:30:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: by hub.freebsd.org (Postfix, from userid 32767) id 468B737C546; Fri, 30 Jun 2000 05:29:13 -0700 (PDT) Message-Id: <20000630122913.468B737C546@hub.freebsd.org> Date: Fri, 30 Jun 2000 05:29:13 -0700 (PDT) From: dot@dotat.at To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-1.0 Subject: docs/19602: Typo in sigaction(2) manual page Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19602 >Category: docs >Synopsis: Typo in sigaction(2) manual page >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 Jun 30 05:30:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Tony Finch >Release: 4.0-STABLE >Organization: Covalent Technologies, Inc. >Environment: FreeBSD hand.dotat.at 4.0-STABLE-20000622 FreeBSD 4.0-STABLE-20000622 #0: Thu Jun 22 04:33:22 GMT 2000 root@hand.dotat.at:/build/obj/build/src/sys/DELL-Latitude-CPx i386 >Description: An incorrect name for one of the elements of struct sigaction is mentioned in the examples section of the manual page. >How-To-Repeat: >Fix: --- sigaction.2.orig Fri Jun 30 11:24:35 2000 +++ sigaction.2 Fri Jun 30 11:23:56 2000 @@ -445,7 +445,7 @@ The handler function should match the SA_SIGINFO prototype if the SA_SIGINFO bit is set in flags. It then should be pointed to by the -.Dv sa_siginfo +.Dv sa_sigaction member of .Dv struct sigaction . Note that you should not assign SIG_DFL or SIG_IGN this way. >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 Jun 30 5:44:18 2000 Delivered-To: freebsd-doc@freebsd.org Received: from smtp.matrix.com.br (smtp.matrix.com.br [200.202.17.7]) by hub.freebsd.org (Postfix) with ESMTP id 89E8637BA05 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 05:44:09 -0700 (PDT) (envelope-from cess@matrix.com.br) Received: from magnus.matrix.com.br (bridge-1.matrix.com.br [200.202.17.22]) by smtp.matrix.com.br (Postfix) with ESMTP id D0AFA60F8F; Fri, 30 Jun 2000 09:44:05 -0300 (EST) Content-Length: 1985 Message-ID: <XFMail.000630094236.cess@matrix.com.br> X-Mailer: XFMail 1.4.0 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <86r99fv2jb.fsf@chimaera.locus> Date: Fri, 30 Jun 2000 09:42:36 -0300 (EST) From: Carlos Eduardo Selonke de Souza <cess@matrix.com.br> To: Harry Newton <harry_newton@telinco.co.uk> Subject: RE: text justification in docbook Cc: freebsd-doc@freebsd.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 30-Jun-00 Harry Newton wrote: > Is it possible to specify that text be fully justified (i.e. flush > left and right edges) when using Docbook/SGML ? I know it's possible > in linuxdoc. > > Would you CC a copy of your reply back to me directly ? Cheers. > Yes Its possible. You have to define a customized stylesheet. I am using Modular DocBook StyleSheets, so my example will be for it. Under the directory that contains your print stylesheets create a file like these: ---------------------------------------------------------------------- <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL> ]> <style-sheet> <style-specification use="docbook"> <style-specification-body> ;; $Id: plain.dsl,v 1.3 1999/07/02 17:30:53 nwalsh Exp $ ;; ;; This file is part of the Modular DocBook Stylesheet distribution. ;; See ../README or http://www.berkshire.net/~norm/dsssl/ ;; ;; Example of a customization layer on top of the modular docbook style ;; sheet. Definitions inserted in this file take precedence over ;; definitions in the 'use'd stylesheet(s). (define %default-quadding% ;; The default quadding 'justify) </style-specification-body> </style-specification> <external-specification id="docbook" document="docbook.dsl"> </style-sheet> ------------------------------------------------------------------------- Them, You could use: #jade -t rtf -d your_customized_stylesheet.dsl foo.sgml You could also read, http://nwalsh.com/docbook/dsssl/doc/print/default-quadding.html It will explain in more details. If you have any doubts you could send me an email. Regards. Carlos Eduardo Selonke de Souza http://www.br-unix.org/users/cess -----BEGIN GEEK CODE BLOCK----- Version:3.1 GE d+@ s+:+ a-- C+++ UB++> P+ !L E W++(+) N+> K- w-- !O !M V- PS+ PE+ Y PGP- t+ 5 X++ R- tv++ b++ DI++ D+ G e++ h r+++ y+++ -----END GEEK CODE BLOCK------ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:10:10 2000 Delivered-To: freebsd-doc@freebsd.org Received: from smtp1.bb.din.or.jp (smtp1.bb.din.or.jp [210.135.65.186]) by hub.freebsd.org (Postfix) with ESMTP id A3D3437BA36; Fri, 30 Jun 2000 07:10:03 -0700 (PDT) (envelope-from iron@bb.din.or.jp) Received: from smtp.bb.din.or.jp (ppp24-021.din.or.jp [210.189.110.52]) by smtp1.bb.din.or.jp (8.9.3+Sun/3.7W) with SMTP id XAA08468; Fri, 30 Jun 2000 23:01:33 +0900 (JST) Message-ID: <200006302303.1389@iron.bb.din.or.jp> Date: Fri, 30 Jun 2000 23:03:04 +0900 From: =?ISO-2022-JP?B?GyRCMkJHNRsoQg==?= <iron@bb.din.or.jp> To: iron@bb.din.or.jp Subject: =?ISO-2022-JP?B?GyRCIiM9UEQlN1A4MyROJCIka0p9ISYhJiEmISMbKEI=?= MIME-Version: 1.0 Content-Type: text/plain; charset="iso-2022-jp" Content-Transfer-Encoding: 7bit X-Mailer: Gen Mail 0.9b Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org $B$O$8$a$^$7$F!"2BG5$H8@$$$^$9!#(B $B:#!";d$OITNQ$7$F$$$^$9!#(B $BLs(B10$B%v7n$[$IA0$KAj<j$NJ}$,=PD%$G6bBt$KMh$?;~$K=P2q$$$^$7$?!#(B $B$=$NJ}$OK?Bg<j@8L?J]812q<R$NItD9$5$s$G!"G/Np$O#4#3:P!#;d$O#2#1:M$G$9!#(B $B:G=i$N:"$O3Z$7$$F|!9$NO"B3$G$7$?!#(B $B$=$l$,!&!&:#$O!&!&EEOC$b>/$J$/$J$j!"(B $BOC$r$7$F$$$F$b$I$3$+Nd$?$$46$8$G!&!&(B $B0JA0$H$OMM;R$,0c$&$s$G$9!#(B $B$d$C$Q$j1s5wN%$N$;$$$G$7$g$&$+!#(B $B=PD%B2$NJ}$C$F$_$s$J:G=i$+$iM7$SL\E*$G=w$N;R$HIU$-9g$&$N$G$7$g$&$+!#(B $B;d!"@5D>$$$C$FBg?M$NCK$N?M$N9M$($,H=$j$^$;$s!#(B $B;d$O$3$N$^$^$GNI$$$N$G$7$g$&$+!#(B $B$"$J$?$O!"$I$&;W$$$^$9$+!#(B $B$3$s$J;d$O%3%3$K$$$^$9!#(B http://www5.plala.or.jp/ver/yoshino/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:22: 2 2000 Delivered-To: freebsd-doc@freebsd.org Received: from cs94004.pp.htv.fi (cs94004.pp.htv.fi [212.90.94.4]) by hub.freebsd.org (Postfix) with ESMTP id 2FE9437B6B2 for <doc@freebsd.org>; Fri, 30 Jun 2000 07:21:54 -0700 (PDT) (envelope-from jau@cs94004.pp.htv.fi) Received: (from jau@localhost) by mjolnir.thunderbolt.fi (8.9.3/8.9.3) id RAA96439 for doc@freebsd.org; Fri, 30 Jun 2000 17:21:22 +0300 (EEST) (envelope-from jau) Message-Id: <200006301421.RAA96439@mjolnir.thunderbolt.fi> Subject: TYPO - http://www.freebsd.org/handbook/contrib-additional.html To: doc@freebsd.org Date: Fri, 30 Jun 2000 17:21:22 +0300 (EET DST) Reply-To: jau@iki.fi From: jau@iki.fi (Jukka A. Ukkonen) Latin-Date: Vineri XXX Iunie a.d. MM Organization: Private person Phone: +358-9-6215280 (home) Content-Conversion: prohibited X-Mailer: ELM [version 2.4 PL25+pgp] MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi! I just noticed my name and e-mail address are mentioned on this http://www.freebsd.org/handbook/contrib-additional.html web page. There seems to be a typo though in my e-mail address. It is not jua@iki.fi as it is currently quoted on the page, but correct form is <jau@iki.fi> The 'a' stands for my middle name Antero. So, naturally it should go before the 'u' for my family name Ukkonen. Cheers, // jau .--- ..- -.- -.- .- .- .-.-.- ..- -.- -.- --- -. . -. / Jukka A. Ukkonen, SysOpen Plc, Finland /__ M.Sc. (sw-eng & cs) (Phone) +358-424-2020-331 / Internet: Jukka.Ukkonen@SysOpen.Fi (Fax) +358-424-2020-700 / Internet: ukkonen@nic.funet.fi (Mobile) +358-400-606-671 v Internet: jau@iki.fi (Home&Fax) +358-9-6215-280 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:26:18 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id C6EE037B806 for <doc@freebsd.org>; Fri, 30 Jun 2000 07:26:14 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 1381k0-000Lh0-00; Fri, 30 Jun 2000 16:26:00 +0200 Date: Fri, 30 Jun 2000 16:26:00 +0200 From: Neil Blakey-Milner <nbm@mithrandr.moria.org> To: "Jukka A. Ukkonen" <jau@iki.fi> Cc: doc@freebsd.org Subject: Re: TYPO - http://www.freebsd.org/handbook/contrib-additional.html Message-ID: <20000630162600.A83362@mithrandr.moria.org> References: <200006301421.RAA96439@mjolnir.thunderbolt.fi> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <200006301421.RAA96439@mjolnir.thunderbolt.fi>; from jau@iki.fi on Fri, Jun 30, 2000 at 05:21:22PM +0300 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > I just noticed my name and e-mail address are mentioned on > this > > http://www.freebsd.org/handbook/contrib-additional.html > > web page. There seems to be a typo though in my e-mail address. > It is not jua@iki.fi as it is currently quoted on the page, but > correct form is > > <jau@iki.fi> > > The 'a' stands for my middle name Antero. So, naturally it > should go before the 'u' for my family name Ukkonen. Oops! (: I've fixed it now, and the changes will hit the web page within a day. Sorry for the mistake. Cheers, Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:27:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.2.163]) by hub.freebsd.org (Postfix) with ESMTP id E31D837B806 for <doc@freebsd.org>; Fri, 30 Jun 2000 07:27:26 -0700 (PDT) (envelope-from sheldonh@axl.ops.uunet.co.za) Received: from sheldonh (helo=axl.ops.uunet.co.za) by axl.ops.uunet.co.za with local-esmtp (Exim 3.13 #1) id 1381kz-0000pQ-00; Fri, 30 Jun 2000 16:27:01 +0200 From: Sheldon Hearn <sheldonh@uunet.co.za> To: jau@iki.fi Cc: doc@FreeBSD.ORG Subject: Re: TYPO - http://www.freebsd.org/handbook/contrib-additional.html In-reply-to: Your message of "Fri, 30 Jun 2000 17:21:22 +0300." <200006301421.RAA96439@mjolnir.thunderbolt.fi> Date: Fri, 30 Jun 2000 16:27:01 +0200 Message-ID: <3187.962375221@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 30 Jun 2000 17:21:22 +0300, Jukka A. Ukkonen wrote: > http://www.freebsd.org/handbook/contrib-additional.html > > web page. There seems to be a typo though in my e-mail address. I'll do this and mail you privately when it's done. It should take me 5 minutes. Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:30:15 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.2.163]) by hub.freebsd.org (Postfix) with ESMTP id 2ED2637BB29 for <doc@freebsd.org>; Fri, 30 Jun 2000 07:30:06 -0700 (PDT) (envelope-from sheldonh@axl.ops.uunet.co.za) Received: from sheldonh (helo=axl.ops.uunet.co.za) by axl.ops.uunet.co.za with local-esmtp (Exim 3.13 #1) id 1381nc-0000qg-00; Fri, 30 Jun 2000 16:29:44 +0200 From: Sheldon Hearn <sheldonh@uunet.co.za> To: Neil Blakey-Milner <nbm@mithrandr.moria.org> Cc: "Jukka A. Ukkonen" <jau@iki.fi>, doc@FreeBSD.ORG Subject: Re: TYPO - http://www.freebsd.org/handbook/contrib-additional.html In-reply-to: Your message of "Fri, 30 Jun 2000 16:26:00 +0200." <20000630162600.A83362@mithrandr.moria.org> Date: Fri, 30 Jun 2000 16:29:44 +0200 Message-ID: <3265.962375384@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 30 Jun 2000 16:26:00 +0200, Neil Blakey-Milner wrote: > I've fixed it now, and the changes will hit the web page within a day. > Sorry for the mistake. Bleh. What works on an office LAN does not always work the world over. :-) Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:34: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mout1.silyn-tek.de (mout1.silyn-tek.de [194.25.165.69]) by hub.freebsd.org (Postfix) with ESMTP id 7317037BC1F for <doc@freebsd.org>; Fri, 30 Jun 2000 07:34:02 -0700 (PDT) (envelope-from alex@big.endian.de) Received: from [192.168.32.34] (helo=mx2.silyn-tek.de) by mout1.silyn-tek.de with esmtp (Exim 3.13 #1) id 1381rl-0007Ff-00; Fri, 30 Jun 2000 16:34:01 +0200 Received: from p3e9d38cf.dip0.t-ipconnect.de ([62.157.56.207] helo=neutron.cichlids.com) by mx2.silyn-tek.de with esmtp (Exim 3.13 #1) id 1381ri-0003Kb-00; Fri, 30 Jun 2000 16:33:58 +0200 Received: from cichlids.cichlids.com (cichlids.cichlids.com [192.168.0.10]) by neutron.cichlids.com (Postfix) with ESMTP id E5A4CAC27; Fri, 30 Jun 2000 16:34:16 +0200 (CEST) Received: by cichlids.cichlids.com (Postfix, from userid 1001) id 8261814A66; Fri, 30 Jun 2000 16:33:52 +0200 (CEST) Date: Fri, 30 Jun 2000 16:33:52 +0200 To: Sheldon Hearn <sheldonh@uunet.co.za> Cc: jau@iki.fi, doc@FreeBSD.ORG Subject: Re: TYPO - http://www.freebsd.org/handbook/contrib-additional.html Message-ID: <20000630163352.A2499@cichlids.cichlids.com> References: <200006301421.RAA96439@mjolnir.thunderbolt.fi> <3187.962375221@axl.ops.uunet.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <3187.962375221@axl.ops.uunet.co.za>; from sheldonh@uunet.co.za on Fri, Jun 30, 2000 at 04:27:01PM +0200 X-PGP-Fingerprint: 44 28 CA 4C 46 5B D3 A8 A8 E3 BA F3 4E 60 7D 7F X-PGP-at: finger alex@big.endian.de X-Verwirrung: Dieser Header dient der allgemeinen Verwirrung. From: alex@big.endian.de (Alexander Langer) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thus spake Sheldon Hearn (sheldonh@uunet.co.za): > I'll do this and mail you privately when it's done. It should take me 5 > minutes. OK. We are _three_ people who have changed that. you want to do it, and nbm did it EXACTLY between my cvs diff -u and my cvs commit :) Alex -- cat: /home/alex/.sig: No such file or directory To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 7:46:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sv01.geocities.co.jp (sv01.geocities.co.jp [210.153.89.155]) by hub.freebsd.org (Postfix) with ESMTP id 5D10437BFB4; Fri, 30 Jun 2000 07:46:42 -0700 (PDT) (envelope-from hrs@geocities.co.jp) Received: from mail.geocities.co.jp (mail.geocities.co.jp [210.153.89.137]) by sv01.geocities.co.jp (8.9.3+3.2W/3.7W) with ESMTP id XAA17428; Fri, 30 Jun 2000 23:46:40 +0900 (JST) Received: from mail.hrs.jp (sutnmax1-ppp40.ed.noda.sut.ac.jp [133.31.173.50]) by mail.geocities.co.jp (1.3G-GeocitiesJ-3.3) with ESMTP id XAA29425; Fri, 30 Jun 2000 23:46:26 +0900 (JST) Message-Id: <200006301446.XAA29425@mail.geocities.co.jp> Received: from localhost (alph.hrs.jp [192.168.0.10]) by mail.hrs.jp (8.9.3/3.7W/DomainMaster) with ESMTP id XAA41667; Fri, 30 Jun 2000 23:05:46 +0900 (JST) (envelope-from hrs@hrs.jp) In-Reply-To: <20000628173144.B51610@catkin.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000628173144.B51610@catkin.nothing-going-on.org> Subject: Re: XML driver config file to replace LINT To: nik@FreeBSD.ORG Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG X-Mailer: Mew version 1.94.1 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, 30 Jun 2000 23:05:46 +0900 From: Hiroki Sato <hrs@geocities.co.jp> X-Dispatcher: imput version 990905(IM130) Lines: 28 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik Clayton <nik@FreeBSD.ORG> wrote in <20000628173144.B51610@catkin.nothing-going-on.org>: > That being the case, it wouldn't be too hard to do > > <commant lang="ja_JP.EUCjp">...</comment> > > <comment lang="es_ES.ISO_8859-1">...</comment> > > and so on, would it? If so, translated comment field can be obsolete while the author's one is always up-to-date. The comment field is edited by the original author, but translators are responsible for the others. Translation is not always done immediately. So, I think a way is needed to indicate whether the translation is old or not. > Or does loading Japanese text in to a non-Japanese aware editor scramble > the text? Probably it is not a big problem for editors, but other tools are OK? A file including characters in various encodings may confuse them. -- | Hiroki Sato/HRS <hrs@geocities.co.jp> | | j7397067@ed.noda.sut.ac.jp(univ) | hrs@jp.FreeBSD.org(FreeBSD doc-jp Project) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 8:17:30 2000 Delivered-To: freebsd-doc@freebsd.org Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id A4F2D37C0A6 for <freebsd-doc@FreeBSD.ORG>; Fri, 30 Jun 2000 08:17:26 -0700 (PDT) (envelope-from mwlucas@blackhelicopters.org) Received: (from mwlucas@localhost) by blackhelicopters.org (8.9.3/8.9.3) id LAA20877; Fri, 30 Jun 2000 11:17:15 -0400 (EDT) (envelope-from mwlucas) From: Michael Lucas <mwlucas@blackhelicopters.org> Message-Id: <200006301517.LAA20877@blackhelicopters.org> Subject: Re: 4.0-release to 4.0-stable has no tarball or iso from which to update from :( In-Reply-To: <000f01bfe236$81dcb620$090a0a0a@frogger> from Terry Motto at "Jun 29, 2000 6:48:34 pm" To: ledermin@reboot.cx (Terry Motto) Date: Fri, 30 Jun 2000 11:17:15 -0400 (EDT) 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 You need CTM. Search for it on the website. Copy the CTM diffs onto your favorite removable media and bring them over to your BSD box. There are no tarballs. ==ml > I am aware of programs like cvsup and such. My problem is that my bsd box isn't connected directly to the internet and it's 4-releast. I would ever so much update it to 4-stable but i cannot find a way to. I've asked numerous times in the Efnet #Freebsdhelp channel what the equivalent of cvsup'ing for the 4-stable so i'm not left out if i do have to download each individual file from my slow modem :( I've noticed a couple previous releases have tarballs of the update, but alas theire is none for 4.0-stable nor a 4.0-stable iso... I know "stable" is a ever changing thing but it would mean so much if i could just download a tarball or the cvsup equiv of all the distributions... please! I use Freebsd on my webserver and i want to use it on my local network as well... > > Terry M. Motto To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 8:40:12 2000 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 751D137BF43 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 08:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA89201; Fri, 30 Jun 2000 08:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sabre.velocet.net (sabre.velocet.net [198.96.118.66]) by hub.freebsd.org (Postfix) with ESMTP id A484A37C003 for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 Jun 2000 08:32:05 -0700 (PDT) (envelope-from dgilbert@office.tor.velocet.net) Received: from office.tor.velocet.net (trooper.velocet.net [216.126.82.226]) by sabre.velocet.net (Postfix) with ESMTP id F37BF137F15 for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 Jun 2000 11:32:00 -0400 (EDT) Received: (from dgilbert@localhost) by office.tor.velocet.net (8.9.3/8.9.3) id LAA91460; Fri, 30 Jun 2000 11:31:21 -0400 (EDT) (envelope-from dgilbert) Message-Id: <200006301531.LAA91460@office.tor.velocet.net> Date: Fri, 30 Jun 2000 11:31:21 -0400 (EDT) From: David Gilbert <dgilbert@velocet.ca> Reply-To: dgilbert@velocet.ca To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19604: Web query interface doesn't seem to work. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19604 >Category: docs >Synopsis: Web query interface doesn't search or Originator correctly >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Jun 30 08:40:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: David Gilbert >Release: FreeBSD 4.0-STABLE i386 >Organization: Velocet Communications >Environment: Netscape 4.7, on FreeBSD-4.0-STALE, I suppose. >Description: When I'm hitting http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query and I enter the Originator of one of my PRs in either the originator field or the single line field of the form, the search comes back blank. This happens whether I search for the whole string or some substring of the originator. >How-To-Repeat: My example originator strings are "dgilbert" and "David Gilbert <dgilbert@velocet.ca>" >Fix: None known. >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 Jun 30 8:58:10 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sysapp.paume.itb.ac.id (sysapp.paume.ITB.ac.id [167.205.21.98]) by hub.freebsd.org (Postfix) with SMTP id AFFA637C160 for <doc@FreeBSD.org>; Fri, 30 Jun 2000 08:58:02 -0700 (PDT) (envelope-from fikar@sysapp.paume.itb.ac.id) Received: (qmail 3729 invoked from network); 30 Jun 2000 19:35:59 -0000 Received: from mnt.paume.itb.ac.id (HELO sysapp.paume.itb.ac.id) (167.205.22.5) by sysapp.paume.itb.ac.id with SMTP; 30 Jun 2000 19:35:59 -0000 Message-ID: <395CF189.D937BF3B@sysapp.paume.itb.ac.id> Date: Fri, 30 Jun 2000 20:14:17 +0100 From: Zulfikar Djafar <fikar@sysapp.paume.itb.ac.id> X-Mailer: Mozilla 4.72 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: doc@FreeBSD.org Subject: [Fwd: help me please..!] Content-Type: multipart/mixed; boundary="------------22F255DD876621A42E14DA95" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This is a multi-part message in MIME format. --------------22F255DD876621A42E14DA95 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit --------------22F255DD876621A42E14DA95 Content-Type: message/rfc822 Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Mozilla-Status2: 00000000 Message-ID: <395CF0FA.472E0B57@sysapp.paume.itb.ac.id> Date: Fri, 30 Jun 2000 20:11:54 +0100 From: Zulfikar Djafar <fikar@sysapp.paume.itb.ac.id> X-Mailer: Mozilla 4.72 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: freebsd-doc@FreeBSD.ORG Subject: help me please..! Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit dear, could you send to me the contents of milist with date : Fri, 08 May 1998 with subject : Re: need sample ip-up and ip-dn scripts.... thank's fikar --------------22F255DD876621A42E14DA95-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 10: 4:58 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 96DD837BDBD; Fri, 30 Jun 2000 10:04:47 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id LAA91502; Fri, 30 Jun 2000 11:04:45 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id LAA42694; Fri, 30 Jun 2000 11:04:43 -0600 (MDT) Message-Id: <200006301704.LAA42694@harmony.village.org> To: Jun Kuriyama <kuriyama@FreeBSD.ORG> Subject: Re: XML driver config file to replace LINT Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Fri, 30 Jun 2000 12:08:50 +0900." <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> References: <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> <20000629144257.A23415@catkin.nothing-going-on.org> <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <200006290024.SAA59981@harmony.village.org> <200006291558.JAA34002@harmony.village.org> Date: Fri, 30 Jun 2000 11:04:43 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> Jun Kuriyama writes: : Of course, source tree are for programmers. First thing we should : consider is not to stress programmers for that procedure. Nik's : suggestion is more conceptual one. We need more discussion for this : subject. I think that a large part of my reaction was the part about going out of our way to force this down the throats of the programmers. On relfection, having dozens of mumble.xml files through the tree that the doc project can use would be good. Having it be the only way to have kernel options might be desirable in some ways, ugly in others. If it is one big .xml file, then I'd have to think that that isn't desrable at all. We're trying to get away from that sort of thing. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 10: 6: 4 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 74F2537C579; Fri, 30 Jun 2000 10:05:55 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id LAA91513; Fri, 30 Jun 2000 11:05:53 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id LAA42717; Fri, 30 Jun 2000 11:05:46 -0600 (MDT) Message-Id: <200006301705.LAA42717@harmony.village.org> To: Garrett Wollman <wollman@khavrinen.lcs.mit.edu> Subject: Re: XML driver config file to replace LINT Cc: Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Thu, 29 Jun 2000 23:39:29 EDT." <200006300339.XAA97675@khavrinen.lcs.mit.edu> References: <200006300339.XAA97675@khavrinen.lcs.mit.edu> <20000629144257.A23415@catkin.nothing-going-on.org> <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> <200006290024.SAA59981@harmony.village.org> <200006291558.JAA34002@harmony.village.org> <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp> Date: Fri, 30 Jun 2000 11:05:46 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <200006300339.XAA97675@khavrinen.lcs.mit.edu> Garrett Wollman writes: : > using XML is same process such as using src/sys/dev/usb/usbdevs. As : > you know, generation of usbdevs{,_data}.h is done by awk script. And : > same procedure is done in src/sys/dev/pccarddevs for generating : > pccarddevs{,_data}.h. : : Both of which are bugs imported from NetBSD. Agreed. I've not taken the time to clean this up. There are some cross module issues in doing this that I'm not clear on how to solve. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 10: 7:43 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 6F69E37C16C; Fri, 30 Jun 2000 10:07:31 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id LAA91522; Fri, 30 Jun 2000 11:07:28 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id LAA42737; Fri, 30 Jun 2000 11:07:25 -0600 (MDT) Message-Id: <200006301707.LAA42737@harmony.village.org> To: Robert Withrow <bwithrow@nortelnetworks.com> Subject: Re: XML driver config file to replace LINT Cc: Garrett Wollman <wollman@khavrinen.lcs.mit.edu>, Jun Kuriyama <kuriyama@FreeBSD.ORG>, doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Fri, 30 Jun 2000 08:27:46 EDT." <200006301227.IAA09413@pobox.engeast.BayNetworks.COM> References: <200006301227.IAA09413@pobox.engeast.BayNetworks.COM> Date: Fri, 30 Jun 2000 11:07:25 -0600 From: Warner Losh <imp@village.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <200006301227.IAA09413@pobox.engeast.BayNetworks.COM> Robert Withrow writes: : : wollman@khavrinen.lcs.mit.edu said: : :- Both of which are bugs imported from NetBSD. : : Obviously a matter of opinion. I think declarative DSLs for : this kind of things are a good idea. The problem is that they are generated files that are checked into the tree. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 10: 9:13 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sysapp.paume.itb.ac.id (sysapp.paume.ITB.ac.id [167.205.21.98]) by hub.freebsd.org (Postfix) with SMTP id 819F537C028 for <freebsd-doc@FreeBSD.ORG>; Fri, 30 Jun 2000 10:09:05 -0700 (PDT) (envelope-from fikar@sysapp.paume.itb.ac.id) Received: (qmail 3719 invoked from network); 30 Jun 2000 19:33:36 -0000 Received: from mnt.paume.itb.ac.id (HELO sysapp.paume.itb.ac.id) (167.205.22.5) by sysapp.paume.itb.ac.id with SMTP; 30 Jun 2000 19:33:36 -0000 Message-ID: <395CF0FA.472E0B57@sysapp.paume.itb.ac.id> Date: Fri, 30 Jun 2000 20:11:54 +0100 From: Zulfikar Djafar <fikar@sysapp.paume.itb.ac.id> X-Mailer: Mozilla 4.72 [en] (WinNT; I) X-Accept-Language: en MIME-Version: 1.0 To: freebsd-doc@FreeBSD.ORG Subject: help me please..! Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org dear, could you send to me the contents of milist with date : Fri, 08 May 1998 with subject : Re: need sample ip-up and ip-dn scripts.... thank's fikar To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 12: 6:16 2000 Delivered-To: freebsd-doc@freebsd.org Received: from merlin.prod.itd.earthlink.net (merlin.prod.itd.earthlink.net [207.217.120.156]) by hub.freebsd.org (Postfix) with ESMTP id 696B337B5FB for <doc@FreeBSD.org>; Fri, 30 Jun 2000 12:06:13 -0700 (PDT) (envelope-from jim@luna.osd.bsdi.com) Received: from luna.osd.bsdi.com (1Cust175.tnt5.beaverton.or.da.uu.net [63.21.232.175]) by merlin.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id MAA18428 for <doc@FreeBSD.org>; Fri, 30 Jun 2000 12:06:11 -0700 (PDT) Received: by luna.osd.bsdi.com (Postfix, from userid 1000) id B67E53143; Fri, 30 Jun 2000 12:06:08 -0700 (PDT) Date: Fri, 30 Jun 2000 12:06:08 -0700 From: Jim Mock <jim@FreeBSD.org> To: doc@FreeBSD.org Subject: New User's Handbook Message-ID: <20000630120608.A5841@luna.osd.bsdi.com> Reply-To: jim@FreeBSD.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.4i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Howdy folks, Since sending the last message on the New User's Handbook, I haven't gotten *any* replies.. has anyone looked at it? It's available at http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ I'd like to commit it before it gets crufty and/or other folks start committing to the chapters that make it up so I don't have to go through the whole thing again. Feedback would be appreciated. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 12:32:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id AC17E37B568; Fri, 30 Jun 2000 12:32:42 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id VAA17616; Fri, 30 Jun 2000 21:32:40 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: jim@FreeBSD.ORG Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook References: <20000630120608.A5841@luna.osd.bsdi.com> From: Rasmus Kaj <kaj@raditex.se> Cc: Rasmus Kaj <kaj@raditex.se> Organization: Raditex AB - http://Raditex.se/ X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^' d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU Date: 30 Jun 2000 21:32:40 +0200 In-Reply-To: Jim Mock's message of "Fri, 30 Jun 2000 12:06:08 -0700" Message-ID: <84d7kz55if.fsf@frodo.sickla.raditex.se> Lines: 57 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "JM" == Jim Mock <jim@FreeBSD.ORG> writes: JM> Howdy folks, JM> Since sending the last message on the New User's Handbook, I haven't JM> gotten *any* replies.. has anyone looked at it? It's available at JM> http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ Ok, here come's a little comment ... I don't really see who the intended reader is here. Anoyone interested in the history and goals of the project probably already know so much that he don't need the "Unix basics" chapter. So, you should either focus on the "Unix basics" part and make a one-page introduction of chapters one to four, or assume the reader knows some unix, but is new to FreeBSD. I would make an appendix of chapter six, and assume most readers know it anyway ... So, what would a new user, knowing some Unix, need? Here's a few items * An introduction to the ports and packages system. * Some words about /etc/rc.conf, other startup scripts etc, and about /stand/sysinstall. * A firm voice telling them not to run -current, and probably some introduction to the mailing lists. And one other thing; Do every document _have_ _to_ start with a full page of copyright information? Why not have a paragraph of introducing text, supposed to make people want to read the document, not scare them away (the handbook has such a paragraph, but it's squeezed in between the copyright line and the page of legal terms). How about putting things like this instead: <h1>Document title</h1> <h2>Author (or "FreeBSD doc project")</h2> A paragraph of text, telling how nice and usefull it would be to read this document. ------------------- (dividing hr) ------------------------------ Table Of Contents. ... ------------------- (dividing hr) ------------------------------ <h2>Legal terms</h2> Redistribution and use in source (SGML DocBook) ... and all that If we do this, people might even start to read the documentation. :-) -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ Where ever I place my .emacs, is my ${HOME}. -LysLysKom \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 12:54:41 2000 Delivered-To: freebsd-doc@freebsd.org Received: from eagle.prod.itd.earthlink.net (eagle.prod.itd.earthlink.net [207.217.120.24]) by hub.freebsd.org (Postfix) with ESMTP id 489B637B6D5 for <doc@FreeBSD.ORG>; Fri, 30 Jun 2000 12:54:38 -0700 (PDT) (envelope-from jim@luna.osd.bsdi.com) Received: from luna.osd.bsdi.com (1Cust175.tnt5.beaverton.or.da.uu.net [63.21.232.175]) by eagle.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id MAA28597; Fri, 30 Jun 2000 12:54:35 -0700 (PDT) Received: by luna.osd.bsdi.com (Postfix, from userid 1000) id AE8EB3143; Fri, 30 Jun 2000 12:54:32 -0700 (PDT) Date: Fri, 30 Jun 2000 12:54:32 -0700 From: Jim Mock <jim@FreeBSD.ORG> To: Rasmus Kaj <kaj@raditex.se> Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook Message-ID: <20000630125432.A6144@luna.osd.bsdi.com> Reply-To: jim@FreeBSD.ORG References: <20000630120608.A5841@luna.osd.bsdi.com> <84d7kz55if.fsf@frodo.sickla.raditex.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.4i In-Reply-To: <84d7kz55if.fsf@frodo.sickla.raditex.se>; from kaj@raditex.se on Fri, Jun 30, 2000 at 09:32:40PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 30 Jun 2000 at 21:32:40 +0200, Rasmus Kaj wrote: > >>>>> "JM" == Jim Mock <jim@FreeBSD.ORG> writes: > > JM> Howdy folks, > JM> Since sending the last message on the New User's Handbook, I > JM> haven't gotten *any* replies.. has anyone looked at it? It's > JM> available at http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ > > Ok, here come's a little comment ... I don't really see who the > intended reader is here. Anoyone interested in the history and goals > of the project probably already know so much that he don't need the > "Unix basics" chapter. > > So, you should either focus on the "Unix basics" part and make a > one-page introduction of chapters one to four, or assume the reader > knows some unix, but is new to FreeBSD. I would make an appendix of > chapter six, and assume most readers know it anyway ... It's intended for people new to FreeBSD and who want to learn a bit about it -- it's been pulled directly from the existing handbook. I sort of get the feeling you haven't read any of the other messages about splitting the handbook up. > So, what would a new user, knowing some Unix, need? Here's a few items > > * An introduction to the ports and packages system. That will be put into the ``Installation Handbook'' along with installing FreeBSD and the ports tree. > * Some words about /etc/rc.conf, other startup scripts etc, and about > /stand/sysinstall. You're missing the point. > * A firm voice telling them not to run -current, and probably some > introduction to the mailing lists. You're missing the point here too. Please go back and read Nik's ``Splitting up the Handbook'' post and the rest of the thread. *sigh* > And one other thing; Do every document _have_ _to_ start with a full > page of copyright information? Why not have a paragraph of > introducing text, supposed to make people want to read the document, > not scare them away (the handbook has such a paragraph, but it's > squeezed in between the copyright line and the page of legal terms). Yes, it does. Why? Because the handbook is being split up into separate books. Each book can then be read (or published) separately and won't have the copyright that's in the handbook now. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 12:59: 3 2000 Delivered-To: freebsd-doc@freebsd.org Received: from eagle.prod.itd.earthlink.net (eagle.prod.itd.earthlink.net [207.217.120.24]) by hub.freebsd.org (Postfix) with ESMTP id 96D2D37BCB9 for <doc@FreeBSD.org>; Fri, 30 Jun 2000 12:59:01 -0700 (PDT) (envelope-from jim@luna.osd.bsdi.com) Received: from luna.osd.bsdi.com (1Cust175.tnt5.beaverton.or.da.uu.net [63.21.232.175]) by eagle.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id MAA23708; Fri, 30 Jun 2000 12:58:58 -0700 (PDT) Received: by luna.osd.bsdi.com (Postfix, from userid 1000) id 419543143; Fri, 30 Jun 2000 12:58:44 -0700 (PDT) Date: Fri, 30 Jun 2000 12:58:44 -0700 From: Jim Mock <jim@FreeBSD.org> To: Scott Flatman <sf@aracnet.com> Cc: doc@FreeBSD.org Subject: Re: New User's Handbook Message-ID: <20000630125844.B6144@luna.osd.bsdi.com> Reply-To: jim@FreeBSD.org References: <20000630120608.A5841@luna.osd.bsdi.com> <Pine.BSF.4.21.0006301216130.660-100000@mephistopheles> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.4i In-Reply-To: <Pine.BSF.4.21.0006301216130.660-100000@mephistopheles>; from sf@aracnet.com on Fri, Jun 30, 2000 at 12:18:20PM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 30 Jun 2000 at 12:18:20 -0700, Scott Flatman wrote: > On Fri, 30 Jun 2000, Jim Mock wrote: > > Howdy folks, > > > > Since sending the last message on the New User's Handbook, I > > haven't gotten *any* replies.. has anyone looked at it? It's > > available at http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ > > > > I'd like to commit it before it gets crufty and/or other folks > > start committing to the chapters that make it up so I don't have to > > go through the whole thing again. > > > > Feedback would be appreciated. > > I like it. > > Short and sweet. Not overwhelming for the beginner. Just enough to > get them started. > > Perhaps a pointer in the Chapter 6 about the FreeBSD mailing lists, > like -questions, for FreeBSD specific help? Good idea. A ``Getting Help'' chapter might be useful here since there really isn't one in the existing handbook anywhere and this ``smaller handbook'' would probably be the one it belongs in when the rest of the existing handbook is split up. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 14:37:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from pawn.primelocation.net (pawn.primelocation.net [205.161.238.235]) by hub.freebsd.org (Postfix) with ESMTP id D128537B5BE for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 14:37:39 -0700 (PDT) (envelope-from jedgar@fxp.org) Received: from earth.causticlabs.com (oca-p1-29.hitter.net [207.192.76.29]) by pawn.primelocation.net (Postfix) with ESMTP id AB5839B1C for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 17:37:32 -0400 (EDT) Date: Fri, 30 Jun 2000 17:37:32 -0400 (EDT) From: "Chris D. Faulhaber" <jedgar@fxp.org> X-Sender: jedgar@earth.causticlabs.com To: freebsd-doc@freebsd.org Subject: Porters-handbook addition Message-ID: <Pine.BSF.4.21.0006301734490.2239-200000@earth.causticlabs.com> MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="0-1441887167-962401052=:2239" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. Send mail to mime@docserver.cac.washington.edu for more info. --0-1441887167-962401052=:2239 Content-Type: TEXT/PLAIN; charset=US-ASCII Due to the number of port submissions that include a README.html file, I would like to add the following to the Do's and Don't's section of the porters-handbook (see attached patch)...comments appreciated. ----- Chris D. Faulhaber - jedgar@fxp.org - jedgar@FreeBSD.org -------------------------------------------------------- FreeBSD: The Power To Serve - http://www.FreeBSD.org --0-1441887167-962401052=:2239 Content-Type: TEXT/PLAIN; charset=US-ASCII; name="porter.diff" Content-Transfer-Encoding: BASE64 Content-ID: <Pine.BSF.4.21.0006301737320.2239@earth.causticlabs.com> Content-Description: Content-Disposition: attachment; filename="porter.diff" SW5kZXg6IGJvb2suc2dtbA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KUkNT IGZpbGU6IC9ob21lL25jdnMvZG9jL2VuX1VTLklTT184ODU5LTEvYm9va3Mv cG9ydGVycy1oYW5kYm9vay9ib29rLnNnbWwsdg0KcmV0cmlldmluZyByZXZp c2lvbiAxLjEwNw0KZGlmZiAtdSAtcjEuMTA3IGJvb2suc2dtbA0KLS0tIGJv b2suc2dtbAkyMDAwLzA2LzE2IDAwOjA0OjAxCTEuMTA3DQorKysgYm9vay5z Z21sCTIwMDAvMDYvMzAgMjE6MzQ6MTMNCkBAIC0zMTQ4LDYgKzMxNDgsMTUg QEANCiAgICAgICA8L3NlY3QxPg0KIA0KICAgICAgIDxzZWN0MT4NCisgICAg ICAgIDx0aXRsZT48ZmlsZW5hbWU+UkVBRE1FLmh0bWw8L2ZpbGVuYW1lPjwv dGl0bGU+DQorDQorICAgICAgICA8cGFyYT5EbyBub3QgaW5jbHVkZSBhIDxm aWxlbmFtZT5SRUFETUUuaHRtbDwvZmlsZW5hbWU+IGZpbGUuICBUaGlzDQor ICAgICAgICAgIGZpbGUgaXMgbm90IHBhcnQgb2YgdGhlIGN2cyBjb2xsZWN0 aW9uIGJ1dCBpcyBnZW5lcmF0ZWQgdXNpbmcgdGhlDQorICAgICAgICAgIDxj b21tYW5kPm1ha2UgcmVhZG1lPC9jb21tYW5kPiBjb21tYW5kLg0KKyAgICAg ICAgPC9wYXJhPg0KKyAgICAgIDwvc2VjdDE+DQorDQorICAgICAgPHNlY3Qx Pg0KICAgICAgICAgPHRpdGxlPk1pc2NlbGxhbmVhPC90aXRsZT4NCiANCiAg ICAgICAgIDxwYXJhPlRoZSBmaWxlcyA8ZmlsZW5hbWU+cGtnL0RFU0NSPC9m aWxlbmFtZT4sDQo= --0-1441887167-962401052=:2239-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 15:48:37 2000 Delivered-To: freebsd-doc@freebsd.org Received: from merlin.prod.itd.earthlink.net (merlin.prod.itd.earthlink.net [207.217.120.156]) by hub.freebsd.org (Postfix) with ESMTP id C705437B9D7 for <freebsd-doc@FreeBSD.ORG>; Fri, 30 Jun 2000 15:48:34 -0700 (PDT) (envelope-from jim@luna.osd.bsdi.com) Received: from luna.osd.bsdi.com (1Cust83.tnt3.beaverton.or.da.uu.net [63.21.224.83]) by merlin.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id PAA26255; Fri, 30 Jun 2000 15:48:32 -0700 (PDT) Received: by luna.osd.bsdi.com (Postfix, from userid 1000) id 0C8BA3143; Fri, 30 Jun 2000 15:21:32 -0700 (PDT) Date: Fri, 30 Jun 2000 15:21:32 -0700 From: Jim Mock <jim@luna.osd.bsdi.com> To: "Chris D. Faulhaber" <jedgar@fxp.org> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Porters-handbook addition Message-ID: <20000630152132.A6846@luna.osd.bsdi.com> Reply-To: jim@luna.osd.bsdi.com References: <Pine.BSF.4.21.0006301734490.2239-200000@earth.causticlabs.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.4i In-Reply-To: <Pine.BSF.4.21.0006301734490.2239-200000@earth.causticlabs.com>; from jedgar@fxp.org on Fri, Jun 30, 2000 at 05:37:32PM -0400 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 30 Jun 2000 at 17:37:32 -0400, Chris D. Faulhaber wrote: > Due to the number of port submissions that include a README.html > file, I would like to add the following to the Do's and Don't's > section of the porters-handbook (see attached patch)...comments > appreciated. Looks good to me. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 15:54:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38]) by hub.freebsd.org (Postfix) with ESMTP id 0B59D37B5F3; Fri, 30 Jun 2000 15:54:25 -0700 (PDT) (envelope-from hamellr@aracnet.com) Received: from shell1.aracnet.com (shell1.aracnet.com [216.99.193.21]) by mail3.aracnet.com (8.9.3/8.9.3) with ESMTP id PAA09352; Fri, 30 Jun 2000 15:54:30 -0700 Received: by shell1.aracnet.com (8.9.3) id PAA30329; Fri, 30 Jun 2000 15:54:39 -0700 Date: Fri, 30 Jun 2000 15:54:39 -0700 (PDT) From: Rick Hamell <hamellr@aracnet.com> To: Jim Mock <jim@FreeBSD.ORG> Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook In-Reply-To: <20000630120608.A5841@luna.osd.bsdi.com> Message-ID: <Pine.LNX.4.21.0006301553410.10953-100000@shell1.aracnet.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > I'd like to commit it before it gets crufty and/or other folks start > committing to the chapters that make it up so I don't have to go through > the whole thing again. > > Feedback would be appreciated. Pretty good I think... on c322.html I'd add http://www.freebsddiary.org maybe. Unless there is a reason to not referance outside sites. Rick To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 16: 7:17 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38]) by hub.freebsd.org (Postfix) with ESMTP id 6B28B37BCA6; Fri, 30 Jun 2000 16:07:12 -0700 (PDT) (envelope-from hamellr@aracnet.com) Received: from shell1.aracnet.com (shell1.aracnet.com [216.99.193.21]) by mail3.aracnet.com (8.9.3/8.9.3) with ESMTP id QAA11529; Fri, 30 Jun 2000 16:07:17 -0700 Received: by shell1.aracnet.com (8.9.3) id QAA32065; Fri, 30 Jun 2000 16:07:26 -0700 Date: Fri, 30 Jun 2000 16:07:26 -0700 (PDT) From: Rick Hamell <hamellr@aracnet.com> To: Jim Mock <jim@FreeBSD.ORG> Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook In-Reply-To: <Pine.LNX.4.21.0006301553410.10953-100000@shell1.aracnet.com> Message-ID: <Pine.LNX.4.21.0006301606100.10953-100000@shell1.aracnet.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Also, on the last page you say to read hier(7). If one dosen't have FreeBSD installed yet, or dosen't know how to read man pages... what should they do? :) Rick To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 16:47:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from monica.et.bocholt.fh-gelsenkirchen.de (monica.et.bocholt.fh-gelsenkirchen.de [193.175.197.63]) by hub.freebsd.org (Postfix) with ESMTP id 8E44A37C3AC for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 16:47:44 -0700 (PDT) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Received: from musashi.et.bocholt.fh-ge.de (reserve.et.bocholt.fh-gelsenkirchen.de [193.175.197.95] (may be forged)) by monica.et.bocholt.fh-gelsenkirchen.de (8.9.3/8.9.3) with ESMTP id BAA14256 for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 01:47:43 +0200 Received: from localhost (localhost.et.bocholt.fh-ge.de [127.0.0.1]) by musashi.et.bocholt.fh-ge.de (8.9.3/8.9.3) with ESMTP id BAA85144 for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 01:48:07 +0200 (CEST) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Message-Id: <200006302348.BAA85144@musashi.et.bocholt.fh-ge.de> From: gouders@et.bocholt.fh-gelsenkirchen.de To: freebsd-doc@freebsd.org Subject: The entity circ and others... Reply-To: gouders@et.bocholt.fh-gelsenkirchen.de Date: Sat, 01 Jul 2000 01:48:07 +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, I recognized that in the HTML output of the FAQ an entity "circ" (circumflex) is included that - as far as I found out - does not exist in HTML up to 4.0. Is that correct? If yes, is it "missing" in HTML or is it "of limited use" in docbook? Another point that bothers me for a long time now: In the FAQ there are several questions that are actually not questions but rather "statements" and therefore do not end with a question mark. Instead, some of them end with a dot and some of them end with no punctuation at all, what looks somewhat inconsistent to me. Are there any suggestions on how to handle such "statements" in an consistent way? Dirk To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 17:40: 7 2000 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 9DBC837B579 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 17:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id RAA55417; Fri, 30 Jun 2000 17:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Fri, 30 Jun 2000 17:40:02 -0700 (PDT) Message-Id: <200007010040.RAA55417@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: John Baldwin <jhb@bsdi.com> Subject: Re: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Reply-To: John Baldwin <jhb@bsdi.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/19583; it has been noted by GNATS. From: John Baldwin <jhb@bsdi.com> To: bmah@cisco.com Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Date: Fri, 30 Jun 2000 17:37:48 -0700 "(Bruce A. Mah)" wrote: > >Fix: > > Index: README.TXT > =================================================================== > RCS file: /usr/local/cvsroot/src/release/texts/README.TXT,v > retrieving revision 1.9.2.3 > diff -c -r1.9.2.3 README.TXT > *** README.TXT 2000/06/26 15:46:18 1.9.2.3 > --- README.TXT 2000/06/29 16:40:35 > *************** > *** 32,38 **** > getting into here (e.g. you've been following -stable) then this > snapshot is probably for you. If you're more interested in doing > business with FreeBSD than in playing with the cutting edge of > ! technology, however, then 3.x or one of the 4.x releases, is almost > certainly your best bet. > > Most information here is also available from the Documentation menu > --- 32,38 ---- > getting into here (e.g. you've been following -stable) then this > snapshot is probably for you. If you're more interested in doing > business with FreeBSD than in playing with the cutting edge of > ! technology, however, then 3.x or one of the 4.x releases, is almost > certainly your best bet. The changed line here should actually read as this: technology, however, then 3.x, or one of the 4.x releases, is almost or this: technology, however, then 3.x or one of the 4.x releases is almost Comments? -- John Baldwin <jhb@bsdi.com> -- http://www.FreeBSD.org/~jhb/ PGP Key: http://www.cslab.vt.edu/~jobaldwi/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 Fri Jun 30 17:59:34 2000 Delivered-To: freebsd-doc@freebsd.org Received: from penguin.prod.itd.earthlink.net (penguin.prod.itd.earthlink.net [207.217.120.134]) by hub.freebsd.org (Postfix) with ESMTP id 8089837C432 for <freebsd-doc@FreeBSD.ORG>; Fri, 30 Jun 2000 17:59:32 -0700 (PDT) (envelope-from eogren@earthlink.net) Received: from rod.darktech.org (ip142.cambridge2.ma.pub-ip.psi.net [38.32.112.142]) by penguin.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id RAA14899; Fri, 30 Jun 2000 17:59:30 -0700 (PDT) Received: (from eogren@localhost) by rod.darktech.org (8.10.1/8.10.1) id e610x9N02094; Fri, 30 Jun 2000 20:59:09 -0400 (EDT) Date: Fri, 30 Jun 2000 20:59:09 -0400 From: Eric Ogren <eogren@earthlink.net> To: John Baldwin <jhb@bsdi.com> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Message-ID: <20000630205909.A2074@earthlink.net> References: <200007010040.RAA55417@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <200007010040.RAA55417@freefall.freebsd.org>; from jhb@bsdi.com on Fri, Jun 30, 2000 at 05:40:02PM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Well, since you asked... :) Personally, I would prefer this sentence looked something like: However, if you're more interested in doing business with FreeBSD than in staying on the cutting edge, then 3.x or one of the 4.x releases is almost certainly for you. I strongly dislike cutting up a sentence with a "however", although this is just a writing style issue, and "playing with the cutting edge of technology" just sounds weird to me, especially since in the handbook we give dire warnings that -CURRENT is not intended to be a plaything for users. Besides, is FreeBSD really the cutting edge "of technology"? Maybe of computer science, but FreeBSD isn't exactly new technology; BSD code has been around for a while... Just my two (probably somewhat nitpickey) cents. Eric On Fri, Jun 30, 2000 at 05:40:02PM -0700, John Baldwin wrote: > > business with FreeBSD than in playing with the cutting edge of > > ! technology, however, then 3.x or one of the 4.x releases, is almost > > certainly your best bet. > > > > Most information here is also available from the Documentation menu > > --- 32,38 ---- > > getting into here (e.g. you've been following -stable) then this > > snapshot is probably for you. If you're more interested in doing > > business with FreeBSD than in playing with the cutting edge of > > ! technology, however, then 3.x or one of the 4.x releases, is almost > > certainly your best bet. > > The changed line here should actually read as this: > > technology, however, then 3.x, or one of the 4.x releases, is almost > > or this: > > technology, however, then 3.x or one of the 4.x releases is almost > > Comments? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 18: 0:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ptd.net (mail1.ha-net.ptd.net [207.44.96.65]) by hub.freebsd.org (Postfix) with SMTP id 7AA9737C3AC for <doc@FreeBSD.org>; Fri, 30 Jun 2000 18:00:45 -0700 (PDT) (envelope-from tms2@mail.ptd.net) Received: (qmail 3546 invoked from network); 1 Jul 2000 01:00:50 -0000 Received: from du172.cli.ptd.net (HELO mail.ptd.net) (204.186.33.172) by mail.ptd.net with SMTP; 1 Jul 2000 01:00:50 -0000 Message-ID: <395D4286.66F85746@mail.ptd.net> Date: Fri, 30 Jun 2000 20:59:50 -0400 From: "Thomas M. Sommers" <tms2@mail.ptd.net> Organization: None X-Mailer: Mozilla 4.72 [en] (X11; I; FreeBSD 4.0-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: jim@FreeBSD.org Cc: doc@FreeBSD.org Subject: Re: New User's Handbook References: <20000630120608.A5841@luna.osd.bsdi.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org If I could make a few suggestions: I think the section on FreeBSD goals should go in the first section, What is FreeBSD. The goals help define what the project is. The first mention of 4.4BSD-Lite should be linked to the history section, to at least indicate to the reader who has never heard of it that it will be explained. I also think that putting the first 5 sections describing FreeBSD in the same document as the Unix Basics sections is a little discordant. They don't really belong together. I would suggest splitting them. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 18: 0:57 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ptd.net (mail1.ha-net.ptd.net [207.44.96.65]) by hub.freebsd.org (Postfix) with SMTP id CEAE037C3AC for <doc@FreeBSD.ORG>; Fri, 30 Jun 2000 18:00:52 -0700 (PDT) (envelope-from tms2@mail.ptd.net) Received: (qmail 3416 invoked from network); 1 Jul 2000 01:00:47 -0000 Received: from du172.cli.ptd.net (HELO mail.ptd.net) (204.186.33.172) by mail.ptd.net with SMTP; 1 Jul 2000 01:00:47 -0000 Message-ID: <395D2AAD.3311CECF@mail.ptd.net> Date: Fri, 30 Jun 2000 19:18:05 -0400 From: "Thomas M. Sommers" <tms2@mail.ptd.net> Organization: None X-Mailer: Mozilla 4.72 [en] (X11; I; FreeBSD 4.0-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: Warner Losh <imp@village.org> Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT References: <395B9762.5B95A329@mail.ptd.net> <395A1950.50ECD8D5@mail.ptd.net> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <200006290019.SAA59924@harmony.village.org> <200006292338.RAA37275@harmony.village.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Warner Losh wrote: > > In message <395B9762.5B95A329@mail.ptd.net> "Thomas M. Sommers" writes: > : I was thinking of something analogous to the way syscalls.master is used > : to generate several files. > > This works well for syscalls.master, but I don't think it would work > well in the driver area. Call me crazy. I will readily admit that I know nothing about how the drivers are implemented, so perhaps I'm the crazy one. If it can be done, though, I think it would be a good idea. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Jun 30 21: 0:12 2000 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 5D3E437B5A7 for <freebsd-doc@freebsd.org>; Fri, 30 Jun 2000 21:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id VAA11033; Fri, 30 Jun 2000 21:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from dannyboy.eyep.net (adsl-207-68-84-132.bellatlantic.net [207.68.84.132]) by hub.freebsd.org (Postfix) with ESMTP id B8EF437B7DD for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 Jun 2000 20:53:07 -0700 (PDT) (envelope-from dannyboy@dannyboy.eyep.net) Received: (from dannyboy@localhost) by dannyboy.eyep.net (8.9.3/8.9.3) id XAA00609; Fri, 30 Jun 2000 23:46:31 -0400 (EDT) (envelope-from dannyboy) Message-Id: <200007010346.XAA00609@dannyboy.eyep.net> Date: Fri, 30 Jun 2000 23:46:31 -0400 (EDT) From: dannyboy@subdimension.com Reply-To: dannyboy@subdimension.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19618: www/en/register.sgml: nits Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19618 >Category: docs >Synopsis: www/en/register.sgml: nits >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 Jun 30 21:00:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Daniel Harris >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: <Humid beyond belief> >Description: Add a missing "the", standardize capitalization, add a missing ":". >How-To-Repeat: >Fix: --- register.sgml.orig Fri Jun 30 23:37:31 2000 +++ register.sgml Fri Jun 30 23:36:16 2000 @@ -9,7 +9,7 @@ &header; <center><font size="4">Register to receive the FreeBSD Newsletter and - subscribe to announce@FreeBSD.org mailing list.</font></center> + subscribe to the announce@FreeBSD.org mailing list.</font></center> <form action="http://www.FreeBSD.org/cgi/reg.cgi" method="post"> <input type="hidden" name="recipient" value="register@FreeBSD.org"><br> @@ -35,14 +35,14 @@ </tr> <tr> - <td>Email address: </td> + <td>Email Address: </td> <td colspan="3" align="left"><input type="text" name="emaila" size="30"></td> </tr> <tr valign="top"> - <td align="left">Address </td> + <td align="left">Address: </td> <td colspan="3" align="left"><input type="text" name="Address" size="30"></td> >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 Jun 30 21:48:41 2000 Delivered-To: freebsd-doc@freebsd.org Received: from dannyboy.eyep.net (adsl-207-68-84-132.bellatlantic.net [207.68.84.132]) by hub.freebsd.org (Postfix) with ESMTP id 09E7F37B751 for <doc@freebsd.org>; Fri, 30 Jun 2000 21:48:38 -0700 (PDT) (envelope-from dannyboy@subdimension.com) Received: from subdimension.com (dannyboy@localhost [127.0.0.1]) by dannyboy.eyep.net (8.9.3/8.9.3) with ESMTP id AAA01460 for <doc@freebsd.org>; Sat, 1 Jul 2000 00:49:24 -0400 (EDT) (envelope-from dannyboy@subdimension.com) Message-ID: <395D7854.FF60A7CC@subdimension.com> Date: Sat, 01 Jul 2000 00:49:24 -0400 From: Daniel Harris <dannyboy@subdimension.com> X-Mailer: Mozilla 4.73 [en] (X11; U; FreeBSD 4.0-STABLE i386) X-Accept-Language: en MIME-Version: 1.0 To: doc@freebsd.org Subject: www/en/releases/index.sgml needs to settle on name for errata Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This page uses both "Errata" and "Errata List" -- which one should we use? I think "Errata List" is redundant, but that's MHO. Comments? -- Daniel Harris dannyboy@subdimension.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Jul 1 2:40:31 2000 Delivered-To: freebsd-doc@freebsd.org Received: from www2.rediffmail.com (www2.rediffmail.com [202.54.124.47]) by hub.freebsd.org (Postfix) with SMTP id D6D9B37B7AC for <Doc@FreeBSD.org>; Sat, 1 Jul 2000 02:40:23 -0700 (PDT) (envelope-from kjh@rediffmail.com) Received: (qmail 4830 invoked by uid 510); 1 Jul 2000 09:38:21 -0000 Date: 1 Jul 2000 09:38:21 -0000 Message-ID: <20000701093821.4829.qmail@www2.rediffmail.com> MIME-Version: 1.0 To: questions@FreeBSD.org <questions@FreeBSD.org> Subject: Our Need Specialix EISA card Cc: Doc@FreeBSD.org <Doc@FreeBSD.org> From: "Kesavan Jagadeesan" <kjh@rediffmail.com> Content-ID: <Sat_Jul__1_15_08_21_IST_2000_0@www2.rediffmail.com> Content-type: text/plain Content-Description: Content-Transfer-Encoding: 7bit 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 Jul 1 6: 0:29 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id C4B9537B516; Sat, 1 Jul 2000 06:00:25 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id PAA22502; Sat, 1 Jul 2000 15:00:24 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: jim@FreeBSD.ORG Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook References: <20000630120608.A5841@luna.osd.bsdi.com> <84d7kz55if.fsf@frodo.sickla.raditex.se> <20000630125432.A6144@luna.osd.bsdi.com> From: Rasmus Kaj <kaj@raditex.se> Cc: Rasmus Kaj <kaj@raditex.se> Organization: Raditex AB - http://Raditex.se/ X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^' d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU Date: 01 Jul 2000 15:00:24 +0200 In-Reply-To: Jim Mock's message of "Fri, 30 Jun 2000 12:54:32 -0700" Message-ID: <847lb6c8ev.fsf@frodo.sickla.raditex.se> Lines: 64 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "JM" == Jim Mock <jim@FreeBSD.ORG> writes: JM> [ ... ] http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ >> [ ... ] I don't really see who the intended reader is >> here. Anoyone interested in the history and goals of the project >> probably already know so much that he don't need the "Unix basics" >> chapter [ ... ] JM> It's intended for people new to FreeBSD and who want to learn a bit JM> about it -- it's been pulled directly from the existing handbook. I JM> sort of get the feeling you haven't read any of the other messages about JM> splitting the handbook up. Ok, I've gone back and reread Nik Claytons message and http://people.freebsd.org/~nik/hb/(comments.txt,new-layout.txt) So, this content almost matches what Nik calls "Read This First". Your calling it "New User's Handbook" got me confused ... Maybe it just needs another title. Also, each book in the set of handbooks needs to have, _on_ _the_ _title-page_, a paragraph describing this individual book and a link to set of handbooks. Something like This is an introduction to FreeBSD. It contains what you need to know before reading the <link>other FreeBSD handbooks</link>. Of course, you might want to squeeze in some more there, and thats Ok, but dont make it longer than, say, six lines ... Maybe it should also contain a link to http://www.FreeBSD.org/ (especially in the print version). >> So, what would a new user, knowing some Unix, need? Here's a few items >> [ ... skipping my "other needed topics" ... ] JM> You're missing the point. You're right. It certainly seems I did. >> And one other thing; Do every document _have_ _to_ start with a full >> page of copyright information? Why not have a paragraph of >> introducing text, supposed to make people want to read the document, >> not scare them away (the handbook has such a paragraph, but it's >> squeezed in between the copyright line and the page of legal terms). JM> Yes, it does. Why? Because the handbook is being split up into JM> separate books. Each book can then be read (or published) separately JM> and won't have the copyright that's in the handbook now. Yes, every book need the copyright info. If I can be allowed to talk only about the HTML rendering a moment, I even agree that it should be on the first page (well, maybe a short version with a link to the "lawyer-speak"). But it can come at the end of the page ... All in all, the first page of a book could be more welcoming. Actually, I do have some knowledge of DocBook and the modular dsssl stylesheets, I'll take a look at this and mail a more specific suggestion to the list ... -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ The more things change, the more they stay insane \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Jul 1 7:20:12 2000 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 1568337BA61 for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 07:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA26317; Sat, 1 Jul 2000 07:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from dannyboy.eyep.net (adsl-207-68-84-132.bellatlantic.net [207.68.84.132]) by hub.freebsd.org (Postfix) with ESMTP id 6CB2437B8A6 for <FreeBSD-gnats-submit@freebsd.org>; Sat, 1 Jul 2000 07:18:53 -0700 (PDT) (envelope-from dannyboy@dannyboy.eyep.net) Received: (from dannyboy@localhost) by dannyboy.eyep.net (8.9.3/8.9.3) id KAA04860; Sat, 1 Jul 2000 10:09:10 -0400 (EDT) (envelope-from dannyboy) Message-Id: <200007011409.KAA04860@dannyboy.eyep.net> Date: Sat, 1 Jul 2000 10:09:10 -0400 (EDT) From: dannyboy@subdimension.com Reply-To: dannyboy@subdimension.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19626: Add newsflash: Tucows BSD Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19626 >Category: docs >Synopsis: Add newsflash: Tucows BSD >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: Sat Jul 01 07:20:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Daniel Harris >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: >Description: See synopsis... >How-To-Repeat: >Fix: Index: newsflash.sgml =================================================================== RCS file: /home/ncvs/www/en/news/newsflash.sgml,v retrieving revision 1.184 diff -u -r1.184 newsflash.sgml --- newsflash.sgml 2000/06/30 12:02:18 1.184 +++ newsflash.sgml 2000/07/01 14:03:54 @@ -41,6 +41,10 @@ history means you can find out about your ports faster and easier.</p></li> + <li><p><b>29-June-2000</b> + <a href="http://www.tucows.com/">Tucows</a> has added a + <a href="http://bsd.tucows.com/">BSD section</a>.</p></li> + <li><p><b>26-June-2000</b> A new committer: <a href="mailto:akiyama@FreeBSD.org">Shunsuke Akiyama</a> (Optical disk driver)</p></li> >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 Jul 1 14:30:45 2000 Delivered-To: freebsd-doc@freebsd.org Received: from monica.et.bocholt.fh-gelsenkirchen.de (monica.et.bocholt.fh-gelsenkirchen.de [193.175.197.63]) by hub.freebsd.org (Postfix) with ESMTP id AA1C637B57A; Sat, 1 Jul 2000 14:30:40 -0700 (PDT) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Received: from musashi.et.bocholt.fh-ge.de (reserve.et.bocholt.fh-gelsenkirchen.de [193.175.197.95] (may be forged)) by monica.et.bocholt.fh-gelsenkirchen.de (8.9.3/8.9.3) with ESMTP id XAA16997; Sat, 1 Jul 2000 23:30:39 +0200 Received: from localhost (localhost.et.bocholt.fh-ge.de [127.0.0.1]) by musashi.et.bocholt.fh-ge.de (8.9.3/8.9.3) with ESMTP id XAA88896; Sat, 1 Jul 2000 23:31:04 +0200 (CEST) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Message-Id: <200007012131.XAA88896@musashi.et.bocholt.fh-ge.de> From: gouders@et.bocholt.fh-gelsenkirchen.de To: freebsd-doc@freebsd.org Cc: freebsd-hackers@freebsd.org Subject: ECU files and MLB BIOS Reply-To: gouders@et.bocholt.fh-gelsenkirchen.de Date: Sat, 01 Jul 2000 23:31:04 +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, I am having understanding/translation problems, again. Can anyone help me with the terms "ECU files" and "MLB BIOS" (Hackers section of the FAQ)? Thanks, Dirk To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Jul 1 14:56:23 2000 Delivered-To: freebsd-doc@freebsd.org Received: from monica.et.bocholt.fh-gelsenkirchen.de (monica.et.bocholt.fh-gelsenkirchen.de [193.175.197.63]) by hub.freebsd.org (Postfix) with ESMTP id 01D2537BA1F for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 14:56:20 -0700 (PDT) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Received: from musashi.et.bocholt.fh-ge.de (reserve.et.bocholt.fh-gelsenkirchen.de [193.175.197.95] (may be forged)) by monica.et.bocholt.fh-gelsenkirchen.de (8.9.3/8.9.3) with ESMTP id XAA17039 for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 23:56:19 +0200 Received: from localhost (localhost.et.bocholt.fh-ge.de [127.0.0.1]) by musashi.et.bocholt.fh-ge.de (8.9.3/8.9.3) with ESMTP id XAA88950 for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 23:56:43 +0200 (CEST) (envelope-from hank@musashi.et.bocholt.fh-ge.de) Message-Id: <200007012156.XAA88950@musashi.et.bocholt.fh-ge.de> From: gouders@et.bocholt.fh-gelsenkirchen.de To: freebsd-doc@freebsd.org Subject: More problems... Reply-To: gouders@et.bocholt.fh-gelsenkirchen.de Date: Sat, 01 Jul 2000 23:56:43 +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, I am having one more problem (sorry for bothering you at a frequency of nearly 1/60 Hz): What I this time cannot solve is a part of the answer to the question "How are Plug N Play ISA cards detected and initialized?" of the hackers section of the FAQ. The underlined part of the following is not absolutely clear to me (maybe because I am not a hacker or because of my poor English) and therefore I'm not exactly sure how to say it in German: However by examining the BIOS info plus the ECU info, the probe ~~~~~~~~~ routines can cause the devices that are PnP to avoid those devices the ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ probe code cannot relocate. ~~~~~~~~~~~~~~~~~~~~~~~~~~ I would be glad if I someone could help me with this. Dirk To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Jul 1 22:50: 7 2000 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 75FF037B6DF for <freebsd-doc@freebsd.org>; Sat, 1 Jul 2000 22:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA03529; Sat, 1 Jul 2000 22:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Sat, 1 Jul 2000 22:50:02 -0700 (PDT) Message-Id: <200007020550.WAA03529@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: bmah@cisco.com (Bruce A. Mah) Subject: Re: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Reply-To: bmah@cisco.com (Bruce A. Mah) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/19583; it has been noted by GNATS. From: bmah@cisco.com (Bruce A. Mah) To: John Baldwin <jhb@bsdi.com> Cc: bmah@cisco.com, FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/19583: [patch] Fix typos in RELENG_4 README.TXT Date: Sat, 01 Jul 2000 22:46:56 -0700 --==_Exmh_1033313552P Content-Type: text/plain; charset=us-ascii If memory serves me right, John Baldwin wrote: > "(Bruce A. Mah)" wrote: > > >Fix: > > > > Index: README.TXT > > =================================================================== > > RCS file: /usr/local/cvsroot/src/release/texts/README.TXT,v > > retrieving revision 1.9.2.3 > > diff -c -r1.9.2.3 README.TXT > > *** README.TXT 2000/06/26 15:46:18 1.9.2.3 > > --- README.TXT 2000/06/29 16:40:35 > > *************** > > *** 32,38 **** > > getting into here (e.g. you've been following -stable) then this > > snapshot is probably for you. If you're more interested in doing > > business with FreeBSD than in playing with the cutting edge of > > ! technology, however, then 3.x or one of the 4.x releases, is almost > > certainly your best bet. > > > > Most information here is also available from the Documentation menu > > --- 32,38 ---- > > getting into here (e.g. you've been following -stable) then this > > snapshot is probably for you. If you're more interested in doing > > business with FreeBSD than in playing with the cutting edge of > > ! technology, however, then 3.x or one of the 4.x releases, is almost > > certainly your best bet. > > The changed line here should actually read as this: > > technology, however, then 3.x, or one of the 4.x releases, is almost > > or this: > > technology, however, then 3.x or one of the 4.x releases is almost > > Comments? Yep, you're right (don't show this to my old English teachers). I think the latter expresses the correct sentiments a little better, at least as how I interpret them. Thanks, Bruce. --==_Exmh_1033313552P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: PGPfreeware 5.0i for non-commercial use MessageID: TqiSPWZIxwE8NX4iAoqFZkCIe7EA+wZP iQA/AwUBOV7XUNjKMXFboFLDEQKCKwCg1pGmFkBpNBJNIJQghHombDhTHUwAn2Gl d09ZZBlir/GQiVmGONuym/cn =M5iM -----END PGP SIGNATURE----- --==_Exmh_1033313552P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Jul 1 23:46:22 2000 Delivered-To: freebsd-doc@freebsd.org Received: from server.baldwin.cx (server.geekhouse.net [64.81.6.52]) by hub.freebsd.org (Postfix) with ESMTP id 2D23737BD37 for <freebsd-doc@FreeBSD.ORG>; Sat, 1 Jul 2000 23:46:12 -0700 (PDT) (envelope-from john@baldwin.cx) Received: from john.baldwin.cx (root@john.baldwin.cx [192.168.1.18]) by server.baldwin.cx (8.9.3/8.9.3) with ESMTP id XAA22127; Sat, 1 Jul 2000 23:46:11 -0700 (PDT) (envelope-from john@baldwin.cx) Received: (from john@localhost) by john.baldwin.cx (8.9.3/8.9.3) id XAA33807; Sat, 1 Jul 2000 23:47:04 -0700 (PDT) (envelope-from john) Message-Id: <200007020647.XAA33807@john.baldwin.cx> X-Mailer: XFMail 1.4.0 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <200007012156.XAA88950@musashi.et.bocholt.fh-ge.de> Date: Sat, 01 Jul 2000 23:47:04 -0700 (PDT) From: John Baldwin <jhb@FreeBSD.ORG> To: gouders@et.bocholt.fh-gelsenkirchen.de Subject: RE: More problems... Cc: freebsd-doc@FreeBSD.ORG Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 01-Jul-00 gouders@et.bocholt.fh-gelsenkirchen.de wrote: > Hi, > > I am having one more problem (sorry for bothering you at a frequency > of nearly 1/60 Hz): > > What I this time cannot solve is a part of the answer to the question > "How are Plug N Play ISA cards detected and initialized?" of the > hackers section of the FAQ. The underlined part of the following is > not absolutely clear to me (maybe because I am not a hacker or > because of my poor English) and therefore I'm not exactly sure how to > say it in German: > > However by examining the BIOS info plus the ECU info, the probe > ~~~~~~~~~ > routines can cause the devices that are PnP to avoid those devices the > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > probe code cannot relocate. > ~~~~~~~~~~~~~~~~~~~~~~~~~~ Eek, that is rough in English. Here is perhaps a clearer English version which may (or may not) help with the translation: However, by examining the BIOS info and the ECU info, device driver probe routines can change the resources of PnP devices to avoid using resources already taken by other drivers. Hope this helps. > I would be glad if I someone could help me with this. > > Dirk Also, if anyone likes that English version better, let me know and I'll commit it. -- John Baldwin <jhb@FreeBSD.org> -- http://www.FreeBSD.org/~jhb/ PGP Key: http://www.cslab.vt.edu/~jobaldwi/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