From owner-freebsd-doc Sun Apr 23 3: 0: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 0E68E37BB55 for ; Sun, 23 Apr 2000 03:00:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id DAA04166; Sun, 23 Apr 2000 03:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id B744137B978 for ; Sun, 23 Apr 2000 02:56:56 -0700 (PDT) (envelope-from nobody@FreeBSD.org) Received: (from nobody@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA03977; Sun, 23 Apr 2000 02:56:56 -0700 (PDT) (envelope-from nobody@FreeBSD.org) Message-Id: <200004230956.CAA03977@freefall.freebsd.org> Date: Sun, 23 Apr 2000 02:56:56 -0700 (PDT) From: allenc@verinet.com To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-1.0 Subject: docs/18174: Documentation error; ancontrol appeared in 4.0, not 3.0 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18174 >Category: docs >Synopsis: Documentation error; ancontrol appeared in 4.0, not 3.0 >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: Sun Apr 23 03:00:02 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Allen Campbell >Release: 4.0-STABLE >Organization: >Environment: FreeBSD const. 4.0-STABLE FreeBSD 4.0-STABLE #0: Sun Apr 23 00:21:05 MDT 2000 root@pragma.:/usr/src/sys/compile/CONST i386 >Description: ancontrol.8 states that ancontrol appeared in FreeBSD 3.0. The initial revision of ancontrol.c appeared with the 4.0-RELEASE tag. >How-To-Repeat: man ancontrol >Fix: *** ancontrol.8.orig Sun Apr 23 03:52:55 2000 --- ancontrol.8 Sun Apr 23 03:53:29 2000 *************** *** 354,360 **** The .Nm command first appeared in ! .Fx 3.0 . .Sh BUGS The statistics counters do not seem to show the amount of transmit and received frames as increasing. --- 354,360 ---- The .Nm command first appeared in ! .Fx 4.0 . .Sh BUGS The statistics counters do not seem to show the amount of transmit and received frames as increasing. >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 Apr 23 7:40: 4 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 C193437B88B for ; Sun, 23 Apr 2000 07:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA05129; Sun, 23 Apr 2000 07:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from oxygen.yy.ics.keio.ac.jp (oxygen.yy.ics.keio.ac.jp [131.113.47.3]) by hub.freebsd.org (Postfix) with ESMTP id 6483B37B6BA for ; Sun, 23 Apr 2000 07:36:52 -0700 (PDT) (envelope-from sanpei@sanpei.org) Received: from lavender.yy.cs.keio.ac.jp (ppp151.dialup.st.keio.ac.jp [131.113.27.151]) by oxygen.yy.ics.keio.ac.jp (8.9.3+3.2W/3.7W) with ESMTP id XAA13432; Sun, 23 Apr 2000 23:36:41 +0900 (JST) (envelope-from sanpei@sanpei.org) Received: (from sanpei@localhost) by lavender.yy.cs.keio.ac.jp (8.9.3/3.7W) id XAA04268; Sun, 23 Apr 2000 23:36:43 +0900 (JST) Message-Id: <200004231436.XAA04268@lavender.yy.cs.keio.ac.jp> Date: Sun, 23 Apr 2000 23:36:43 +0900 (JST) From: sanpei@sanpei.org Reply-To: sanpei@sanpei.org To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18177: [Patch] print message was wrong about PC-Card irq in sysinstall Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18177 >Category: docs >Synopsis: [Patch] print message was wrong about PC-Card irq in sysinstall >Confidential: no >Severity: critical >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Apr 23 07:40:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: MIHIRA Yoshiro >Release: FreeBSD 5.0-CURRENT i386 >Organization: Yokohama, Japan >Environment: >Description: In installation floppy and NOTE-PC, user could specify IRQs that CAN be used by PC-Card(internally, sysinstall set -i option for pccardd). But current print messages in sysinstall was wrong(typo?). [wrong message] Please specify an IRQs that CANNOT be used by PC-card. ~~~ [correct message] Please specify an IRQs that CAN be used by PC-card. This problem was in all releases(3-stable/4-stale/5-current). I hope to fix this typo ASAP. Thank you. >How-To-Repeat: boot-up install floppy with NOTE-PC. >Fix: --- src/release/sysinstall/pccard.c.org Sun Apr 23 23:27:27 2000 +++ src/release/sysinstall/pccard.c Sun Apr 23 23:28:11 2000 @@ -44,7 +44,7 @@ DMenu MenuCardIRQ = { DMENU_NORMAL_TYPE | DMENU_SELECTION_RETURNS, "Please select IRQs that can be used by PC-cards", - "Please specify an IRQs that CANNOT be used by PC-card.\n" + "Please specify an IRQs that CAN be used by PC-card.\n" "For example, if you have a sound card that can't be probed by\n" "this installation floppy and it uses IRQ 10, you have to \n" "choose \"Option 1\" or \"Option 2\" at this menu.\n", >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 Apr 23 9:40: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 E076D37B880; Sun, 23 Apr 2000 09:40:21 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Received: (from mpp@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id JAA16591; Sun, 23 Apr 2000 09:40:21 -0700 (PDT) (envelope-from mpp@FreeBSD.org) Date: Sun, 23 Apr 2000 09:40:21 -0700 (PDT) From: Message-Id: <200004231640.JAA16591@freefall.freebsd.org> To: allenc@verinet.com, mpp@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/18174: Documentation error; ancontrol appeared in 4.0, not 3.0 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: Documentation error; ancontrol appeared in 4.0, not 3.0 State-Changed-From-To: open->closed State-Changed-By: mpp State-Changed-When: Sun Apr 23 09:40:08 PDT 2000 State-Changed-Why: Fixed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 10:55:58 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id C520437B9A5; Sun, 23 Apr 2000 10:55:42 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from ec-nortel-0089.wcnet.net [216.88.253.91] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id A9182DA0232; Sun, 23 Apr 2000 12:55:36 -0500 Date: Sun, 23 Apr 2000 17:58:43 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: doc@freebsd.org Cc: ports@freebsd.org Subject: man page for cscope (fwd) Message-ID: MIME-Version: 1.0 Content-Type: MULTIPART/Mixed; BOUNDARY="0-459701646-956529040=:1382" Content-ID: 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-459701646-956529040=:1382 Content-Type: TEXT/PLAIN; CHARSET=US-ASCII Content-ID: It looks like I whiffed the first time this was sent. Here we go again. ---------- Forwarded message ---------- Date: Sun, 23 Apr 2000 17:30:40 -0500 (CDT) From: John Estess To: darrylo@sr.hp.com Cc: doc@freebsd.org, ports@freebsd.org Subject: man page for cscope I was BORED and somewhat useless yesterday, so in the search to do something constructive, I formatted the cscope man page in mdoc style. This is my first foray into mdoc land, so you might say I have issues with groff - like why it insist on double spacing some lines and why it won't let me use periods sometimes. Groff seems to do exactly what it groff wants, regardless of input. Regardless, minus a period or two and an extra space, the man page is a faithful reproduction of the SCO page, but looks much better. If no one else wants to do the port, I'll do it. It looks straightforward (famous last words). I'll need your patches. Please? If I'm stepping on someone's toes, you can gladly take the man page and use it. John Estess jestess@wcnet.net --0-459701646-956529040=:1382 Content-Type: TEXT/PLAIN; CHARSET=US-ASCII; NAME="cscope.1" Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: ATTACHMENT; FILENAME="cscope.1" LkRkIEFwcmlsIDIyLCAyMDAwDQouRHQgQ1NDT1BFIDENCi5PcyBGcmVlQlNE IDQuMA0KLlNoIE5BTUUNCi5ObSBjc2NvcGUNCi5OZCBpbnRlcmFjdGl2ZWx5 IGV4YW1pbmUgYSBDIHByb2dyYW0gDQouU2ggU1lOT1BTSVMNCi5ObSBjc2Nv cGUNCi5PcCBbb3B0aW9uc10NCi5PcCBbZmlsZSAuIC4gLiBdDQouU2ggREVT Q1JJUFRJT04NCi5ObQ0KaXMgYW4gaW50ZXJhY3RpdmUsIHNjcmVlbi1vcmll bnRlZCB0b29sIHRoYXQgYWxsb3dzIHRoZSB1c2VyIHRvIGJyb3dzZSB0aHJv dWdoIEMgc291cmNlIGZpbGVzIGZvciBzcGVjaWZpZWQgZWxlbWVudHMgb2Yg Y29kZS4NCkJ5IGRlZmF1bHQsDQouTm0NCmV4YW1pbmVzIHRoZSBDICguYyBh bmQgLmgpLCBsZXggKC5sKSwgYW5kIHlhY2MgKC55KSBzb3VyY2UgZmlsZXMg aW4gdGhlIGN1cnJlbnQgZGlyZWN0b3J5Lg0KLk5tIA0KbWF5IGFsc28gYmUg aW52b2tlZCBmb3Igc291cmNlIGZpbGVzIG5hbWVkIG9uIHRoZSBjb21tYW5k IGxpbmUuDQpJbiBlaXRoZXIgY2FzZSwgDQouTm0NCnNlYXJjaGVzIHRoZSBz dGFuZGFyZCBkaXJlY3RvcmllcyBmb3IgI2luY2x1ZGUgZmlsZXMgdGhhdCBp dCBkb2VzIG5vdCBmaW5kIGluIHRoZSBjdXJyZW50IGRpcmVjdG9yeS4NCi5O bQ0KdXNlcyBhIHN5bWJvbCBjcm9zcy1yZWZlcmVuY2UsDQouUGEgY3Njb3Bl Lm91dA0KYnkgZGVmYXVsdCwgdG8gbG9jYXRlIGZ1bmN0aW9ucywgZnVuY3Rp b24gY2FsbHMsIG1hY3JvcywgdmFyaWFibGVzLCBhbmQgcHJlcHJvY2Vzc29y IHN5bWJvbHMgaW4gdGhlIGZpbGVzLg0KICAgDQouTm0NCmJ1aWxkcyB0aGUg c3ltYm9sIGNyb3NzLXJlZmVyZW5jZSB0aGUgZmlyc3QgdGltZSBpdCBpcyB1 c2VkIG9uIHRoZSBzb3VyY2UgZmlsZXMgZm9yIHRoZSBwcm9ncmFtIGJlaW5n IGJyb3dzZWQuDQpPbiBhIHN1YnNlcXVlbnQgaW52b2NhdGlvbiwNCi5ObQ0K cmVidWlsZHMgdGhlIGNyb3NzLXJlZmVyZW5jZSBvbmx5IGlmIGEgc291cmNl IGZpbGUgaGFzIGNoYW5nZWQgb3IgdGhlIGxpc3Qgb2Ygc291cmNlIGZpbGVz IGlzIGRpZmZlcmVudC4NCldoZW4gdGhlIGNyb3NzLXJlZmVyZW5jZSBpcyBy ZWJ1aWx0LCB0aGUgZGF0YSBmb3IgdGhlIHVuY2hhbmdlZCBmaWxlcyBhcmUg Y29waWVkIGZyb20gdGhlIG9sZCBjcm9zcy1yZWZlcmVuY2UsIHdoaWNoIG1h a2VzIHJlYnVpbGRpbmcgZmFzdGVyIHRoYW4gdGhlIGluaXRpYWwgYnVpbGQu DQogICANClRoZSBmb2xsb3dpbmcgb3B0aW9ucyBjYW4gYXBwZWFyIGluIGFu eSBjb21iaW5hdGlvbjoNCi5CbCAtdGFnIC13aWR0aCBpbmRlbnQNCi5JdCBG bCBiDQpCdWlsZCB0aGUgY3Jvc3MtcmVmZXJlbmNlIG9ubHkuDQouSXQgRmwg Qw0KSWdub3JlIGxldHRlciBjYXNlIHdoZW4gc2VhcmNoaW5nLg0KLkl0IEZs IGMNClVzZSBvbmx5IEFTQ0lJIGNoYXJhY3RlcnMgaW4gdGhlIGNyb3NzLXJl ZmVyZW5jZSBmaWxlLA0KdGhhdCBpcywgZG8gbm90IGNvbXByZXNzIHRoZSBk YXRhLg0KLkl0IEZsIGQNCkRvIG5vdCB1cGRhdGUgdGhlIGNyb3NzLXJlZmVy ZW5jZS4NCi5JdCBGbCBlDQpTdXBwcmVzcyB0aGUgPEN0cmw+LWUgY29tbWFu ZCBwcm9tcHQgYmV0d2VlbiBmaWxlcy4NCi5JdCBGbCBGIHN5bWZpbGUNClJl YWQgc3ltYm9sIHJlZmVyZW5jZSBsaW5lcyBmcm9tIHN5bWZpbGUuIChBIHN5 bWJvbCByZWZlcmVuY2UgZmlsZSBpcyBjcmVhdGVkIGJ5ID4gYW5kID4+LCBh bmQgY2FuIGFsc28gYmUgcmVhZCB1c2luZyB0aGUgPCBjb21tYW5kLCBkZXNj cmliZWQgdW5kZXIgYGBJc3N1aW5nIFN1YnNlcXVlbnQgUmVxdWVzdHMsJycg YmVsb3cuKQ0KLkl0IEZsIGYgcmVmZmlsZQ0KVXNlIHJlZmZpbGUgYXMgdGhl IGNyb3NzLXJlZmVyZW5jZSBmaWxlIG5hbWUgaW5zdGVhZCBvZiB0aGUgZGVm YXVsdA0KLlBhIGNzY29wZS5vdXQuDQouSXQgRmwgSSBpbmNkaXINCkxvb2sg aW4gaW5jZGlyIChiZWZvcmUgbG9va2luZyBpbiBJTkNESVIsIHRoZSBzdGFu ZGFyZCBwbGFjZSBmb3IgaGVhZGVyIGZpbGVzLA0Kbm9ybWFsbHkNCi5QYSAv dXNyL2luY2x1ZGUNCikgZm9yIGFueSAjaW5jbHVkZSBmaWxlcyB3aG9zZSBu YW1lcyBkbyBub3QgYmVnaW4gd2l0aCBgYC8nJyBhbmQgdGhhdCBhcmUgbm90 IHNwZWNpZmllZCBvbiB0aGUgY29tbWFuZCBsaW5lIG9yIGluIG5hbWVmaWxl IGJlbG93Lg0KKFRoZSAjaW5jbHVkZSBmaWxlcyBtYXkgYmUgc3BlY2lmaWVk IHdpdGggZWl0aGVyIGRvdWJsZSBxdW90ZXMgb3IgYW5nbGUgYnJhY2tldHMu KQ0KVGhlIGluY2RpciBkaXJlY3RvcnkgaXMgc2VhcmNoZWQgaW4gYWRkaXRp b24gdG8gdGhlIGN1cnJlbnQgZGlyZWN0b3J5ICh3aGljaCBpcyBzZWFyY2hl ZCBmaXJzdCkgYW5kIHRoZSBzdGFuZGFyZCBsaXN0ICh3aGljaCBpcyBzZWFy Y2hlZCBsYXN0KS4NCklmIG1vcmUgdGhhbiBvbmUgb2NjdXJyZW5jZSBvZg0K LkZsIEkNCmFwcGVhcnMsIHRoZSBkaXJlY3RvcmllcyBhcmUgc2VhcmNoZWQg aW4gdGhlIG9yZGVyIHRoZXkgYXBwZWFyIG9uIHRoZSBjb21tYW5kIGxpbmUu DQouSXQgRmwgaSBuYW1lZmlsZQ0KQnJvd3NlIHRocm91Z2ggYWxsIHNvdXJj ZSBmaWxlcyB3aG9zZSBuYW1lcyBhcmUgbGlzdGVkIGluIG5hbWVmaWxlDQou UHEgZmlsZSBuYW1lcyBzZXBhcmF0ZWQgYnkgc3BhY2VzLCB0YWJzLCBvciBu ZXctbGluZXMNCmluc3RlYWQgb2YgdGhlIGRlZmF1bHQNCi5QcSBQYSBjc2Nv cGUuZmlsZXMgLg0KSWYgdGhpcyBvcHRpb24gaXMgc3BlY2lmaWVkLA0KLk5t DQppZ25vcmVzIGFueSBmaWxlcyBhcHBlYXJpbmcgb24gdGhlIGNvbW1hbmQg bGluZS4NCi5JdCBGbCBMDQpEbyBhIHNpbmdsZSBzZWFyY2ggd2l0aCBsaW5l LW9yaWVudGVkIG91dHB1dCB3aGVuIHVzZWQgd2l0aCB0aGUNCi5GbCBudW0N CnBhdHRlcm4gb3B0aW9uLg0KLkl0IEZsIGwNCkxpbmUtb3JpZW50ZWQgaW50 ZXJmYWNlIChzZWUgYGBMaW5lLU9yaWVudGVkIEludGVyZmFjZScnIGJlbG93 KS4NCi5JdCBGbCBudW0gcGF0dGVybg0KR28gdG8gaW5wdXQgZmllbGQgbnVt IChjb3VudGluZyBmcm9tIDApIGFuZCBmaW5kIHBhdHRlcm4uDQouSXQgRmwg UCBwYXRoDQpQcmVwZW5kIHBhdGggdG8gcmVsYXRpdmUgZmlsZSBuYW1lcyBp biBhIHByZS1idWlsdA0KY3Jvc3MtcmVmZXJlbmNlIGZpbGUgc28geW91IGRv IG5vdCBoYXZlIHRvIGNoYW5nZSB0byB0aGUNCmRpcmVjdG9yeSB3aGVyZSB0 aGUgY3Jvc3MtcmVmZXJlbmNlIGZpbGUgd2FzIGJ1aWx0LiBUaGlzIG9wdGlv bg0KaXMgb25seSB2YWxpZCB3aXRoIHRoZQ0KLkZsIGQNCm9wdGlvbi4NCi5J dCBGbCBwIG4NCkRpc3BsYXkgdGhlIGxhc3QNCi5TeSBuDQpmaWxlIHBhdGgg Y29tcG9uZW50cyBpbnN0ZWFkIG9mIHRoZSBkZWZhdWx0DQooMSkuIFVzZSAw IHRvIG5vdCBkaXNwbGF5IHRoZSBmaWxlIG5hbWUgYXQgYWxsLg0KLkl0IEZs IHENCkJ1aWxkIGFuIGludmVydGVkIGluZGV4IGZvciBxdWljayBzeW1ib2wg c2VhcmNoaW5nLg0KSWYgeW91IHVzZSB0aGlzIG9wdGlvbiB3aXRoIHRoZQ0K LkZsIGYNCm9wdGlvbiwgeW91IG11c3QgdXNlDQouRmwgZg0Kb24gZXZlcnkg Y2FsbCB0bw0KLk5tDQosIGluY2x1ZGluZyB3aGVuIHlvdSBidWlsZCB0aGUg Y3Jvc3MtcmVmZXJlbmNlIGZpbGUsDQpiZWNhdXNlIGl0IGNoYW5nZXMgdGhl IG5hbWVzIG9mIHRoZSBpbnZlcnRlZCBpbmRleCBmaWxlcy4NCi5JdCBGbCBz IGRpcg0KTG9vayBpbiBkaXIgZm9yIGFkZGl0aW9uYWwgc291cmNlIGZpbGVz Lg0KVGhpcyBvcHRpb24gaXMgaWdub3JlZCBpZiBzb3VyY2UgZmlsZXMgYXJl IGdpdmVuIG9uIHRoZSBjb21tYW5kIGxpbmUuDQouSXQgRmwgVA0KVXNlIG9u bHkgdGhlIGZpcnN0IGVpZ2h0IGNoYXJhY3RlcnMgdG8gbWF0Y2ggYWdhaW5z dCBDIHN5bWJvbHMuDQpBIHJlZ3VsYXIgZXhwcmVzc2lvbiBjb250YWluaW5n IHNwZWNpYWwgY2hhcmFjdGVycyBvdGhlciB0aGFuIGENCnBlcmlvZCAoLikg d2lsbCBub3QgbWF0Y2ggYW55IHN5bWJvbCBpZiBpdHMgbWluaW11bSBsZW5n dGggaXMNCmdyZWF0ZXIgdGhhbiBlaWdodCBjaGFyYWN0ZXJzLg0KLkl0IEZs IFUNCkNoZWNrIGZpbGUgdGltZSBzdGFtcHMuIFRoaXMgb3B0aW9uIHdpbGwg dXBkYXRlIHRoZSB0aW1lIHN0YW1wDQpvbiB0aGUgZGF0YWJhc2UgZXZlbiBp ZiBubyBmaWxlcyBoYXZlIGNoYW5nZWQuDQouSXQgRmwgdQ0KVW5jb25kaXRp b25hbGx5IGJ1aWxkIHRoZSBjcm9zcy1yZWZlcmVuY2UgZmlsZSAoYXNzdW1l IHRoYXQgYWxsIGZpbGVzIGhhdmUgY2hhbmdlZCkuDQouSXQgRmwgVg0KUHJp bnQgb24gdGhlIGZpcnN0IGxpbmUgb2Ygc2NyZWVuIHRoZSB2ZXJzaW9uIG51 bWJlciBvZg0KLk5tDQouDQouUHAgICAgICAgICANClRoZSANCi5GbCBJDQos DQouRmwgcA0KLA0KLkZsIHENCiwgYW5kDQouRmwgVA0Kb3B0aW9ucyBjYW4g YWxzbyBiZSBpbiB0aGUNCi5QYSBjc2NvcGUuZmlsZXMNCmZpbGUuDQouRWwN Ci5QcA0KLlNzIFJlcXVlc3RpbmcgdGhlIGluaXRpYWwgc2VhcmNoDQouUHAN CkFmdGVyIHRoZSBjcm9zcy1yZWZlcmVuY2UgaXMgcmVhZHksDQouTm0NCndp bGwgZGlzcGxheSB0aGlzIG1lbnU6DQouUHANCi5CbCAtaW5zZXQgLW9mZnNl dCAtaW5kZW50IC1jb21wYWN0DQouSXQgICANCkZpbmQgdGhpcyBDIHN5bWJv bDoNCi5JdA0KRmluZCB0aGlzIGZ1bmN0aW9uIGRlZmluaXRpb246DQouSXQN CkZpbmQgZnVuY3Rpb25zIGNhbGxlZCBieSB0aGlzIGZ1bmN0aW9uOg0KLkl0 DQpGaW5kIGZ1bmN0aW9ucyBjYWxsaW5nIHRoaXMgZnVuY3Rpb246DQouSXQN CkZpbmQgdGhpcyB0ZXh0IHN0cmluZzoNCi5JdA0KQ2hhbmdlIHRoaXMgdGV4 dCBzdHJpbmc6DQouSXQNCkZpbmQgdGhpcyBlZ3JlcCBwYXR0ZXJuOg0KLkl0 DQpGaW5kIHRoaXMgZmlsZToNCi5JdA0KRmluZCBmaWxlcyAjaW5jbHVkaW5n IHRoaXMgZmlsZToNCi5FbA0KLlBwICAgDQpQcmVzcyB0aGUgPFRhYj4ga2V5 IHJlcGVhdGVkbHkgdG8gbW92ZSB0byB0aGUgZGVzaXJlZCBpbnB1dCBmaWVs ZCwNCnR5cGUgdGhlIHRleHQgdG8gc2VhcmNoIGZvciwgYW5kIHRoZW4gcHJl c3MgdGhlIDxSZXR1cm4+IGtleS4NCi5QcCAgIA0KLlNzIElzc3Vpbmcgc3Vi c2VxdWVudCByZXF1ZXN0cw0KLlBwDQpJZiB0aGUgc2VhcmNoIGlzIHN1Y2Nl c3NmdWwsDQphbnkgb2YgdGhlc2Ugc2luZ2xlLWNoYXJhY3RlciBjb21tYW5k cyBjYW4gYmUgdXNlZDoNCi5CbCAtdGFnIC13aWR0aCBpbmRlbnQNCi5JdCBT eSAxLTkNCkVkaXQgdGhlIGZpbGUgcmVmZXJlbmNlZCBieSB0aGUgZ2l2ZW4g bGluZSBudW1iZXIuDQouSXQgQXEgU3kgU3BhY2UNCkRpc3BsYXkgbmV4dCBz ZXQgb2YgbWF0Y2hpbmcgbGluZXMuDQouSXQgU3kgKw0KRGlzcGxheSBuZXh0 IHNldCBvZiBtYXRjaGluZyBsaW5lcy4NCi5JdCBTeSAtIA0KRGlzcGxheSBw cmV2aW91cyBzZXQgb2YgbWF0Y2hpbmcgbGluZXMuDQouSXQgU3kgXmUNCkVk aXQgZGlzcGxheWVkIGZpbGVzIGluIG9yZGVyLg0KLkl0IFN5ID4NCldyaXRl IHRoZSBkaXNwbGF5ZWQgbGlzdCBvZiBsaW5lcyB0byBhIGZpbGUuDQouSXQg U3kgPj4NCkFwcGVuZCB0aGUgZGlzcGxheWVkIGxpc3Qgb2YgbGluZXMgdG8g YSBmaWxlLg0KLkl0IFN5IDwNClJlYWQgbGluZXMgZnJvbSBhIGZpbGUgdGhh dCBpcyBpbiBzeW1ib2wgcmVmZXJlbmNlIGZvcm1hdA0KKGNyZWF0ZWQgYnkg PiBvciA+PiksIGp1c3QgbGlrZSB0aGUgLUYgb3B0aW9uLg0KLkl0IFN5IF4N CkZpbHRlciBhbGwgbGluZXMgdGhyb3VnaCBhIHNoZWxsIGNvbW1hbmQgYW5k IGRpc3BsYXkgdGhlDQpyZXN1bHRpbmcgbGluZXMsIHJlcGxhY2luZyB0aGUg bGluZXMgdGhhdCB3ZXJlIGFscmVhZHkgdGhlcmUuDQouSXQgU3kgfA0KUGlw ZSBhbGwgbGluZXMgdG8gYSBzaGVsbCBjb21tYW5kIGFuZCBkaXNwbGF5IHRo ZW0gd2l0aG91dCBjaGFuZ2luZyB0aGVtLg0KLkVsDQouUHANCkF0IGFueSB0 aW1lIHRoZXNlIHNpbmdsZS1jaGFyYWN0ZXIgY29tbWFuZHMgY2FuIGFsc28g YmUgdXNlZDoNCi5CbCAtdGFnIC13aWR0aCBpbmRlbnQNCi5JdCBBcSBTeSBU YWINCk1vdmUgdG8gbmV4dCBpbnB1dCBmaWVsZC4NCi5JdCBBcSBTeSBSZXR1 cm4NCk1vdmUgdG8gbmV4dCBpbnB1dCBmaWVsZC4NCi5JdCBTeSBebg0KTW92 ZSB0byBuZXh0IGlucHV0IGZpZWxkLg0KLkl0IFN5IF5wDQpNb3ZlIHRvIHBy ZXZpb3VzIGlucHV0IGZpZWxkLg0KLkl0IFN5IF55DQpTZWFyY2ggd2l0aCB0 aGUgbGFzdCB0ZXh0IHR5cGVkLg0KLkl0IFN5IF5iDQpNb3ZlIHRvIHByZXZp b3VzIGlucHV0IGZpZWxkIGFuZCBzZWFyY2ggcGF0dGVybi4NCi5JdCBTeSBe Zg0KTW92ZSB0byBuZXh0IGlucHV0IGZpZWxkIGFuZCBzZWFyY2ggcGF0dGVy bi4NCi5JdCBTeSBeYw0KVG9nZ2xlIGlnbm9yZS91c2UgbGV0dGVyIGNhc2Ug d2hlbiBzZWFyY2hpbmcuIChXaGVuIGlnbm9yaW5nIGxldHRlciBjYXNlLA0K c2VhcmNoIGZvciBgYEZJTEUnJyB3aWxsIG1hdGNoIGBgRmlsZScnIGFuZCBg YGZpbGUnJy4pDQouSXQgU3kgXnINClJlYnVpbGQgdGhlIGNyb3NzLXJlZmVy ZW5jZS4NCi5JdCBTeSAhDQpTdGFydCBhbiBpbnRlcmFjdGl2ZSBzaGVsbCAo dHlwZSBeZCB0byByZXR1cm4gdG8NCi5ObSANCikuDQouSXQgU3kgXmwNClJl ZHJhdyB0aGUgc2NyZWVuLg0KLkl0IFN5ID8NCkdpdmUgaGVscCBpbmZvcm1h dGlvbiBhYm91dA0KLk5tDQpjb21tYW5kcy4NCi5JdCBTeSBeZA0KRXhpdA0K Lk5tDQouRWwNCi5QcA0KTk9URTogSWYgdGhlIGZpcnN0IGNoYXJhY3RlciBv ZiB0aGUgdGV4dCB0byBiZSBzZWFyY2hlZCBmb3IgbWF0Y2hlcyBvbmUgb2Yg dGhlIGFib3ZlIGNvbW1hbmRzLA0KZXNjYXBlIGl0IGJ5IHR5cGluZyBhIFwg KGJhY2tzbGFzaCkgZmlyc3QuDQouUHANCi5TcyBTdWJzdGl0dXRpbmcgbmV3 IHRleHQgZm9yIG9sZCB0ZXh0DQouUHANCkFmdGVyIHRoZSB0ZXh0IHRvIGJl IGNoYW5nZWQgaGFzIGJlZW4gdHlwZWQsDQouTm0NCndpbGwgcHJvbXB0IGZv ciB0aGUgbmV3IHRleHQsDQphbmQgdGhlbiBpdCB3aWxsIGRpc3BsYXkgdGhl IGxpbmVzIGNvbnRhaW5pbmcgdGhlIG9sZCB0ZXh0Lg0KU2VsZWN0IHRoZSBs aW5lcyB0byBiZSBjaGFuZ2VkIHdpdGggdGhlc2Ugc2luZ2xlLWNoYXJhY3Rl ciBjb21tYW5kczoNCi5CbCAtdGFnIC13aWR0aCBpbmRlbnQNCi5JdCAxLTkN Ck1hcmsgb3IgdW5tYXJrIHRoZSBsaW5lIHRvIGJlIGNoYW5nZWQuDQouSXQg KiANCk1hcmsgb3IgdW5tYXJrIGFsbCBkaXNwbGF5ZWQgbGluZXMgdG8gYmUg Y2hhbmdlZC4NCi5JdCBBcSBTcGFjZQ0KRGlzcGxheSBuZXh0IHNldCBvZiBs aW5lcy4NCi5JdCArDQpEaXNwbGF5IG5leHQgc2V0IG9mIGxpbmVzLg0KLkl0 IC0NCkRpc3BsYXkgcHJldmlvdXMgc2V0IG9mIGxpbmVzLg0KLkl0IGENCk1h cmsgb3IgdW5tYXJrIGFsbCBsaW5lcyB0byBiZSBjaGFuZ2VkLg0KLkl0IF5k DQpDaGFuZ2UgdGhlIG1hcmtlZCBsaW5lcyBhbmQgZXhpdC4NCi5JdCBBcSBF c2MNCkV4aXQgd2l0aG91dCBjaGFuZ2luZyB0aGUgbWFya2VkIGxpbmVzLg0K Lkl0ICENClN0YXJ0IGFuIGludGVyYWN0aXZlIHNoZWxsICh0eXBlIF5kIHRv IHJldHVybiB0bw0KLk5tDQopLg0KLkl0IF5sDQpSZWRyYXcgdGhlIHNjcmVl bi4NCi5JdCA/DQpHaXZlIGhlbHAgaW5mb3JtYXRpb24gYWJvdXQNCi5ObQ0K Y29tbWFuZHMuDQouRWwNCi5QcA0KLlNzIFNwZWNpYWwga2V5cw0KLlBwDQpJ ZiB5b3VyIHRlcm1pbmFsIGhhcyBhcnJvdyBrZXlzIHRoYXQgd29yayBpbiB2 aSwgeW91IGNhbiB1c2UgdGhlbQ0KdG8gbW92ZSBhcm91bmQgdGhlIGlucHV0 IGZpZWxkcy4gVGhlIHVwLWFycm93IGtleSBpcyB1c2VmdWwgdG8gbW92ZSB0 byB0aGUNCnByZXZpb3VzIGlucHV0IGZpZWxkIGluc3RlYWQgb2YgdXNpbmcg dGhlIDxUYWI+IGtleSByZXBlYXRlZGx5LiBJZiB5b3UgaGF2ZQ0KPENMRUFS PiwgPE5FWFQ+LCBvciA8UFJFVj4ga2V5cyB0aGV5IHdpbGwgYWN0IGFzIHRo ZSBebCwgKywgYW5kIC0gY29tbWFuZHMsIHJlc3BlY3RpdmVseS4NCi5QcA0K LlNzIExpbmUtT3JpZW50ZWQgaW50ZXJmYWNlDQouUHANClRoZSAtbCBvcHRp b24gbGV0cyB5b3UgdXNlDQouTm0NCndoZXJlIGEgc2NyZWVuLW9yaWVudGVk IGludGVyZmFjZSB3b3VsZCBub3QgYmUgdXNlZnVsLCBmb3IgZXhhbXBsZSwN CmZyb20gYW5vdGhlciBzY3JlZW4tb3JpZW50ZWQgcHJvZ3JhbS4NCi5QcCAg IA0KLk5tDQp3aWxsIHByb21wdCB3aXRoID4+IHdoZW4gaXQgaXMgcmVhZHkg Zm9yIGFuIGlucHV0IGxpbmUgc3RhcnRpbmcNCndpdGggdGhlIGZpZWxkIG51 bWJlciAoY291bnRpbmcgZnJvbSAwKSBpbW1lZGlhdGVseSBmb2xsb3dlZCBi eSB0aGUNCnNlYXJjaCBwYXR0ZXJuLCBmb3IgZXhhbXBsZSwgYGBsbWFpbicn IGZpbmRzIHRoZSBkZWZpbml0aW9uIG9mIHRoZQ0KbWFpbiBmdW5jdGlvbi4N Ci5QcA0KSWYgeW91IGp1c3Qgd2FudCBhIHNpbmdsZSBzZWFyY2gsIGluc3Rl YWQgb2YgdGhlIC1sIG9wdGlvbiB1c2UgdGhlIC1MDQphbmQgLW51bSBwYXR0 ZXJuIG9wdGlvbnMsIGFuZCB5b3Ugd29uJ3QgZ2V0IHRoZSA+PiBwcm9tcHQu DQouUHAgIA0KRm9yIC1sLA0KLk5tDQpvdXRwdXRzIHRoZSBudW1iZXIgb2Yg cmVmZXJlbmNlIGxpbmVzDQouTm0NCjogMiBsaW5lcw0KLlBwDQpGb3IgZWFj aCByZWZlcmVuY2UgZm91bmQsDQouTm0NCm91dHB1dHMgYSBsaW5lIGNvbnNp c3Rpbmcgb2YgdGhlIGZpbGUgbmFtZSwNCmZ1bmN0aW9uIG5hbWUsIGxpbmUg bnVtYmVyLCBhbmQgbGluZSB0ZXh0LCBzZXBhcmF0ZWQgYnkgc3BhY2VzLA0K Zm9yIGV4YW1wbGUsIG1haW4uYyBtYWluIDE2MSBtYWluKGFyZ2MsIGFyZ3Yp DQouUHANCk5vdGUgdGhhdCB0aGUgZWRpdG9yIGlzIG5vdCBjYWxsZWQgdG8g ZGlzcGxheSBhIHNpbmdsZSByZWZlcmVuY2UsDQp1bmxpa2UgdGhlIHNjcmVl bi1vcmllbnRlZCBpbnRlcmZhY2UuDQouUHANCllvdSBjYW4gdXNlIHRoZSBj IGNvbW1hbmQgdG8gdG9nZ2xlIGlnbm9yZS91c2UgbGV0dGVyIGNhc2Ugd2hl bg0Kc2VhcmNoaW5nLiAoV2hlbiBpZ25vcmluZyBsZXR0ZXIgY2FzZSwgc2Vh cmNoIGZvciBgYEZJTEUnJyB3aWxsIG1hdGNoDQpgYEZpbGUnJyBhbmQgYGBm aWxlJycuKQ0KLlBwDQpZb3UgY2FuIHVzZSB0aGUgciBjb21tYW5kIHRvIHJl YnVpbGQgdGhlIGRhdGFiYXNlLg0KLlBwICAgDQouTm0NCndpbGwgcXVpdCB3 aGVuIGl0IGRldGVjdHMgZW5kLW9mLWZpbGUsIG9yIHdoZW4gdGhlIGZpcnN0 DQpjaGFyYWN0ZXIgb2YgYW4gaW5wdXQgbGluZSBpcyBgYF5kJycgb3IgYGBx JycuDQouUHANCi5CbCAtdGFnIC13aWR0aCBpbmRlbnQNCi5TcyBFbnZpcm9u bWVudCB2YXJpYWJsZXMNCi5JdCBFdiBFRElUT1INClByZWZlcnJlZCBlZGl0 b3IsIHdoaWNoIGRlZmF1bHRzIHRvIHZpLg0KLkl0IEV2IEhPTUUNCkhvbWUg ZGlyZWN0b3J5LCB3aGljaCBpcyBhdXRvbWF0aWNhbGx5IHNldCBhdCBsb2dp bi4NCi5JdCBFdiBJTkNMVURFRElSUw0KQ29sb24tc2VwYXJhdGVkIGxpc3Qg b2YgZGlyZWN0b3JpZXMgdG8gc2VhcmNoIGZvciAjaW5jbHVkZSBmaWxlcy4N Ci5JdCBFdiBTSEVMTA0KUHJlZmVycmVkIHNoZWxsLCB3aGljaCBkZWZhdWx0 cyB0byBzaC4NCi5JdCBFdiBTT1VSQ0VESVJTDQpDb2xvbi1zZXBhcmF0ZWQg bGlzdCBvZiBkaXJlY3RvcmllcyB0byBzZWFyY2ggZm9yIGFkZGl0aW9uYWwg c291cmNlIGZpbGVzLg0KLkl0IEV2IFRFUk0NClRlcm1pbmFsIHR5cGUsIHdo aWNoIG11c3QgYmUgYSBzY3JlZW4gdGVybWluYWwuDQouSXQgRXYgVEVSTUlO Rk8NClRlcm1pbmFsIGluZm9ybWF0aW9uIGRpcmVjdG9yeSBmdWxsIHBhdGgg bmFtZS4NCklmIHlvdXIgdGVybWluYWwgaXMgbm90IGluIHRoZSBzdGFuZGFy ZCB0ZXJtaW5mbyBkaXJlY3RvcnksDQpzZWUgY3Vyc2VzIGFuZCB0ZXJtaW5m byBmb3IgaG93IHRvIG1ha2UgeW91ciBvd24gdGVybWluYWwgZGVzY3JpcHRp b24uDQouSXQgRXYgVE1QRElSDQpUZW1wb3JhcnkgZmlsZSBkaXJlY3Rvcnks IHdoaWNoIGRlZmF1bHRzIHRvIC92YXIvdG1wLg0KLkl0IEV2IFZJRVdFUg0K UHJlZmVycmVkIGZpbGUgZGlzcGxheSBwcm9ncmFtIChzdWNoIGFzIGxlc3Mp LA0Kd2hpY2ggb3ZlcnJpZGVzIEVESVRPUiAoc2VlIGFib3ZlKS4NCi5JdCBF diBWUEFUSA0KQSBjb2xvbi1zZXBhcmF0ZWQgbGlzdCBvZiBkaXJlY3Rvcmll cywgZWFjaCBvZiB3aGljaCBoYXMgdGhlDQpzYW1lIGRpcmVjdG9yeSBzdHJ1 Y3R1cmUgYmVsb3cgaXQuIElmIFZQQVRIIGlzIHNldCwNCi5ObQ0Kc2VhcmNo ZXMgZm9yIHNvdXJjZSBmaWxlcyBpbiB0aGUgZGlyZWN0b3JpZXMgc3BlY2lm aWVkOw0KaWYgaXQgaXMgbm90IHNldCwNCi5ObQ0Kc2VhcmNoZXMgb25seSBp biB0aGUgY3VycmVudCBkaXJlY3RvcnkuDQouRWwNCi5QcCAgICAgICAgICAN Ci5TcyBGaWxlcw0KLkJsIC10YWcgLXdpZHRoIGluZGVudA0KLkl0IEVtIGNz Y29wZS5maWxlcw0KRGVmYXVsdCBmaWxlcyBjb250YWluaW5nIC1JICwgLXAs IC1xLCBhbmQgLVQgb3B0aW9ucyBhbmQgdGhlDQpsaXN0IG9mIHNvdXJjZSBm aWxlcyAob3ZlcnJpZGRlbiBieSB0aGUgLWkgb3B0aW9uKS4NCi5JdCBFbSBj c2NvcGUub3V0DQpTeW1ib2wgY3Jvc3MtcmVmZXJlbmNlIGZpbGUgKG92ZXJy aWRkZW4gYnkgdGhlIC1mIG9wdGlvbiksDQp3aGljaCBpcyBwdXQgaW4gdGhl IGhvbWUgZGlyZWN0b3J5IGlmIGl0IGNhbm5vdCBiZSBjcmVhdGVkIGluDQp0 aGUgY3VycmVudCBkaXJlY3RvcnkuDQouSXQgRW0gY3Njb3BlLmluLm91dCwg Y3Njb3BlLnBvLm91dA0KRGVmYXVsdCBmaWxlcyBjb250YWluaW5nIHRoZSBp bnZlcnRlZCBpbmRleCB1c2VkIGZvciBxdWljayBzeW1ib2wgc2VhcmNoaW5n DQooLXEgb3B0aW9uKS4gSWYgeW91IHVzZSB0aGUgLWYgb3B0aW9uIHRvIHJl bmFtZSB0aGUgY3Jvc3MtcmVmZXJlbmNlIGZpbGUNCihzbyBpdCdzIG5vdCBj c2NvcGUub3V0DQopLCB0aGUgbmFtZXMgZm9yIHRoZXNlIGludmVydGVkIGlu ZGV4IGZpbGVzIHdpbGwNCmJlIGNyZWF0ZWQgYnkgYWRkaW5nIC5pbiBhbmQg LnBvIHRvIHRoZSBuYW1lIHlvdSBzdXBwbHkgd2l0aCAtZi4NCkZvciBleGFt cGxlLCBpZiB5b3UgaW5kaWNhdGVkIC1mIHh5eiwgdGhlbiB0aGVzZSBmaWxl cyB3b3VsZCBiZSBuYW1lZA0KeHl6LmluIGFuZCB4eXoucG8uDQouSXQgRW0g SU5DRElSDQpTdGFuZGFyZCBkaXJlY3RvcnkgZm9yICNpbmNsdWRlIGZpbGVz ICh1c3VhbGx5IC91c3IvaW5jbHVkZSkuDQouRWwNCi5QcA0KLlNzIE5vdGlj ZXMNCi5QcA0KLk5tDQpyZWNvZ25pemVzIGZ1bmN0aW9uIGRlZmluaXRpb25z IG9mIHRoZSBmb3JtOg0KLlBwDQpmbmFtZSBibGFuayAoIGFyZ3MgKSB3aGl0 ZSBhcmdfZGVjcyB3aGl0ZSB7DQouQmwgLXRhZyAtd2lkdGggaW5kZW50DQou SXQgU3kgd2hlcmU6DQouSXQgZm5hbWUNCmlzIHRoZSBmdW5jdGlvbiBuYW1l DQouSXQgYmxhbmsNCmlzIHplcm8gb3IgbW9yZSBzcGFjZXMgb3IgdGFicywg bm90IGluY2x1ZGluZyBuZXdsaW5lcw0KLkl0IGFyZ3MNCmlzIGFueSBzdHJp bmcgdGhhdCBkb2VzIG5vdCBjb250YWluIGEgYGAiJycgb3IgYSBuZXdsaW5l DQouSXQgd2hpdGUNCmlzIHplcm8gb3IgbW9yZSBzcGFjZXMsIHRhYnMsIG9y IG5ld2xpbmVzDQouSXQgYXJnX2RlY3MNCmFyZSB6ZXJvIG9yIG1vcmUgYXJn dW1lbnQgZGVjbGFyYXRpb25zIChhcmdfZGVjcyBtYXkgaW5jbHVkZQ0KY29t bWVudHMgYW5kIHdoaXRlIHNwYWNlKQ0KLkVsDQouUHAgICAgICAgICANCkl0 IGlzIG5vdCBuZWNlc3NhcnkgZm9yIGEgZnVuY3Rpb24gZGVjbGFyYXRpb24g dG8gc3RhcnQgYXQgdGhlDQpiZWdpbm5pbmcgb2YgYSBsaW5lLiBUaGUgcmV0 dXJuIHR5cGUgbWF5IHByZWNlZGUgdGhlIGZ1bmN0aW9uIG5hbWU7DQouTm0N CndpbGwgc3RpbGwgcmVjb2duaXplIHRoZSBkZWNsYXJhdGlvbi4gRnVuY3Rp b24gZGVmaW5pdGlvbnMgdGhhdA0KZGV2aWF0ZSBmcm9tIHRoaXMgZm9ybSB3 aWxsIG5vdCBiZSByZWNvZ25pemVkIGJ5DQouTm0NCi5QcA0KVGhlIGBgRnVu Y3Rpb24nJyBjb2x1bW4gb2YgdGhlIHNlYXJjaCBvdXRwdXQgZm9yIHRoZSBt ZW51IG9wdGlvbiBGaW5kDQpmdW5jdGlvbnMgY2FsbGVkIGJ5IHRoaXMgZnVu Y3Rpb246IGlucHV0IGZpZWxkIHdpbGwgb25seSBkaXNwbGF5IHRoZQ0KZmly c3QgZnVuY3Rpb24gY2FsbGVkIGluIHRoZSBsaW5lLCB0aGF0IGlzLCBmb3Ig dGhpcyBmdW5jdGlvbg0KLkJsIC1pbnNldCAtb2Zmc2V0IGluZGVudCAtY29t cGFjdA0KLkl0IGUoKQ0KLkl0IHsNCi5JdCByZXR1cm4gKGYoKSArIGcoKSk7 DQouSXQgfQ0KLkVsDQp0aGUgZGlzcGxheSB3b3VsZCBiZToNCi5CbCAtaW5z ZXQgLW9mZnNldCBpbmRlbnQgLWNvbXBhY3QNCi5JdA0KRnVuY3Rpb25zIGNh bGxlZCBieSB0aGlzIGZ1bmN0aW9uOiBlDQouSXQNCkZpbGUgRnVuY3Rpb24g TGluZQ0KLkl0DQphLmMgZiAzIHJldHVybihmKCkgKyBnKCkpOw0KLkVsDQou UHANCk9jY2FzaW9uYWxseSwgYSBmdW5jdGlvbiBkZWZpbml0aW9uIG9yIGNh bGwgbWF5IG5vdCBiZSByZWNvZ25pemVkDQpiZWNhdXNlIG9mIGJyYWNlcyBp bnNpZGUgI2lmIHN0YXRlbWVudHMuIFNpbWlsYXJseSwgdGhlIHVzZSBvZiBh DQp2YXJpYWJsZSBtYXkgYmUgaW5jb3JyZWN0bHkgcmVjb2duaXplZCBhcyBh IGRlZmluaXRpb24uDQouUHANCkEgdHlwZWRlZiBuYW1lIHByZWNlZGluZyBh IHByZXByb2Nlc3NvciBzdGF0ZW1lbnQgd2lsbCBiZSBpbmNvcnJlY3RseSBy ZWNvZ25pemVkIGFzIGENCmdsb2JhbCBkZWZpbml0aW9uLCBmb3IgZXhhbXBs ZSwNCi5CbCAtaW5zZXQgLW9mZnNldCBpbmRlbnQgLWNvbXBhY3QNCi5JdCBM REZJTEUgICoNCi5JdCAjaWYgQVIxNldSDQouRWwNCi5QcA0KUHJlcHJvY2Vz c29yIHN0YXRlbWVudHMgY2FuIGFsc28gcHJldmVudCB0aGUgcmVjb2duaXRp b24gb2YgYSBnbG9iYWwNCmRlZmluaXRpb24sIGZvciBleGFtcGxlLA0KLkJs IC1pbnNldCAtb2Zmc2V0IGluZGVudCAtY29tcGFjdA0KLkl0IGNoYXIgZmxh Zw0KLkl0ICNpZmRlZiBBTExPQ0FURV9TVE9SQUdFDQouSXQgPSAtMQ0KLkl0 ICNlbmRpZg0KLkl0IDsNCi5FbA0KLlBwDQpBIGZ1bmN0aW9uIGRlY2xhcmF0 aW9uIGluc2lkZSBhIGZ1bmN0aW9uIGlzIGluY29ycmVjdGx5IHJlY29nbml6 ZWQgYXMNCmEgZnVuY3Rpb24gY2FsbCwgZm9yIGV4YW1wbGUsDQouQmwgLWlu c2V0IC1vZmZzZXQgaW5kZW50IC1jb21wYWN0DQouSXQgZigpDQouSXQgew0K Lkl0IHZvaWQgZygpOw0KLkl0IH0NCi5FbA0KaXMgaW5jb3JyZWN0bHkgcmVj b2duaXplZCBhcyBhIGNhbGwgdG8gZy4NCi5QcCAgIA0KLk5tDQpyZWNvZ25p emVzIEMrKyBjbGFzc2VzIGJ5IGxvb2tpbmcgZm9yIHRoZSBjbGFzcyBrZXl3 b3JkLCBidXQNCmRvZXNuJ3QgcmVjb2duaXplIHRoYXQgYSBzdHJ1Y3QgaXMg YWxzbyBhIGNsYXNzLCBzbyBpdCBkb2Vzbid0DQpyZWNvZ25pemUgaW5saW5l IG1lbWJlciBmdW5jdGlvbiBkZWZpbml0aW9ucyBpbiBhIHN0cnVjdHVyZS4g SXQgYWxzbw0KZG9lc24ndCBleHBlY3QgdGhlIGNsYXNzIGtleXdvcmQgaW4g YSB0eXBlZGVmLCBzbyBpdCBpbmNvcnJlY3RseQ0KcmVjb2duaXplcyBYIGFz IGEgZGVmaW5pdGlvbiBpbg0KLkJsIC1pbnNldCAtb2Zmc2V0IGluZGVudCAt Y29tcGFjdA0KLkl0IHR5cGVkZWYgY2xhc3MgWCAgKiAgWTsNCi5FbA0KLlBw DQpJdCBhbHNvIGRvZXNuJ3QgcmVjb2duaXplIG9wZXJhdG9yIGZ1bmN0aW9u IGRlZmluaXRpb25zDQouQmwgLWluc2V0IC1vZmZzZXQgaW5kZW50IC1jb21w YWN0DQouSXQgQm9vbCBGZWF0dXJlOjpvcGVyYXRvcj09KGNvbnN0IEZlYXR1 cmUgJiBvdGhlcikNCi5JdCB7DQouSXQgLi4uDQouSXQgfQ0KLkVsDQouUHAN Ck5vciBkb2VzIGl0IHJlY29nbml6ZSBmdW5jdGlvbiBkZWZpbml0aW9ucw0K d2l0aCBhIGZ1bmN0aW9uIHBvaW50ZXIgYXJndW1lbnQuDQouQmwgLWluc2V0 IC1vZmZzZXQgaW5kZW50IC1jb21wYWN0DQouSXQgUGFyc2VUYWJsZTo6UmVj b2duaXplKGludCBzdGFydFN0YXRlLCANCi5JdCBjaGFyICpwYXR0ZXJuLCBp bnQgZmluaXNoU3RhdGUsDQouSXQgdm9pZCAoKkZpbmFsQWN0aW9uKShjaGFy ICopKQ0KLkl0IHsNCi5JdCAuLi4NCi5JdCB9DQouRWwNCi5TaCBDT1BZUklH SFQNCjE3IEFwcmlsIDIwMDAgVGhlIFNhbnRhIENydXogT3BlcmF0aW9uLCBJ bmMuIA0KICAgDQo= --0-459701646-956529040=:1382-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 11:21:13 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id 1620337B8E4; Sun, 23 Apr 2000 11:20:51 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from ec-nortel-0089.wcnet.net [216.88.253.91] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id AEFB411023A; Sun, 23 Apr 2000 13:20:43 -0500 Date: Sun, 23 Apr 2000 18:23:50 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: doc@freebsd.org Cc: ports@freebsd.org Subject: cscope man page in text Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org My apologies - I didn't know Pine sent attachments in Mime. ____________________________________________________________ .Dd April 22, 2000 .Dt CSCOPE 1 .Os FreeBSD 4.0 .Sh NAME .Nm cscope .Nd interactively examine a C program .Sh SYNOPSIS .Nm cscope .Op [options] .Op [file . . . ] .Sh DESCRIPTION .Nm is an interactive, screen-oriented tool that allows the user to browse through C source files for specified elements of code. By default, .Nm examines the C (.c and .h), lex (.l), and yacc (.y) source files in the current directory. .Nm may also be invoked for source files named on the command line. In either case, .Nm searches the standard directories for #include files that it does not find in the current directory. .Nm uses a symbol cross-reference, .Pa cscope.out by default, to locate functions, function calls, macros, variables, and preprocessor symbols in the files. .Nm builds the symbol cross-reference the first time it is used on the source files for the program being browsed. On a subsequent invocation, .Nm rebuilds the cross-reference only if a source file has changed or the list of source files is different. When the cross-reference is rebuilt, the data for the unchanged files are copied from the old cross-reference, which makes rebuilding faster than the initial build. The following options can appear in any combination: .Bl -tag -width indent .It Fl b Build the cross-reference only. .It Fl C Ignore letter case when searching. .It Fl c Use only ASCII characters in the cross-reference file, that is, do not compress the data. .It Fl d Do not update the cross-reference. .It Fl e Suppress the -e command prompt between files. .It Fl F symfile Read symbol reference lines from symfile. (A symbol reference file is created by > and >>, and can also be read using the < command, described under ``Issuing Subsequent Requests,'' below.) .It Fl f reffile Use reffile as the cross-reference file name instead of the default .Pa cscope.out. .It Fl I incdir Look in incdir (before looking in INCDIR, the standard place for header files, normally .Pa /usr/include ) for any #include files whose names do not begin with ``/'' and that are not specified on the command line or in namefile below. (The #include files may be specified with either double quotes or angle brackets.) The incdir directory is searched in addition to the current directory (which is searched first) and the standard list (which is searched last). If more than one occurrence of .Fl I appears, the directories are searched in the order they appear on the command line. .It Fl i namefile Browse through all source files whose names are listed in namefile .Pq file names separated by spaces, tabs, or new-lines instead of the default .Pq Pa cscope.files . If this option is specified, .Nm ignores any files appearing on the command line. .It Fl L Do a single search with line-oriented output when used with the .Fl num pattern option. .It Fl l Line-oriented interface (see ``Line-Oriented Interface'' below). .It Fl num pattern Go to input field num (counting from 0) and find pattern. .It Fl P path Prepend path to relative file names in a pre-built cross-reference file so you do not have to change to the directory where the cross-reference file was built. This option is only valid with the .Fl d option. .It Fl p n Display the last .Sy n file path components instead of the default (1). Use 0 to not display the file name at all. .It Fl q Build an inverted index for quick symbol searching. If you use this option with the .Fl f option, you must use .Fl f on every call to .Nm , including when you build the cross-reference file, because it changes the names of the inverted index files. .It Fl s dir Look in dir for additional source files. This option is ignored if source files are given on the command line. .It Fl T Use only the first eight characters to match against C symbols. A regular expression containing special characters other than a period (.) will not match any symbol if its minimum length is greater than eight characters. .It Fl U Check file time stamps. This option will update the time stamp on the database even if no files have changed. .It Fl u Unconditionally build the cross-reference file (assume that all files have changed). .It Fl V Print on the first line of screen the version number of .Nm . .Pp The .Fl I , .Fl p , .Fl q , and .Fl T options can also be in the .Pa cscope.files file. .El .Pp .Ss Requesting the initial search .Pp After the cross-reference is ready, .Nm will display this menu: .Pp .Bl -inset -offset -indent -compact .It Find this C symbol: .It Find this function definition: .It Find functions called by this function: .It Find functions calling this function: .It Find this text string: .It Change this text string: .It Find this egrep pattern: .It Find this file: .It Find files #including this file: .El .Pp Press the key repeatedly to move to the desired input field, type the text to search for, and then press the key. .Pp .Ss Issuing subsequent requests .Pp If the search is successful, any of these single-character commands can be used: .Bl -tag -width indent .It Sy 1-9 Edit the file referenced by the given line number. .It Aq Sy Space Display next set of matching lines. .It Sy + Display next set of matching lines. .It Sy - Display previous set of matching lines. .It Sy ^e Edit displayed files in order. .It Sy > Write the displayed list of lines to a file. .It Sy >> Append the displayed list of lines to a file. .It Sy < Read lines from a file that is in symbol reference format (created by > or >>), just like the -F option. .It Sy ^ Filter all lines through a shell command and display the resulting lines, replacing the lines that were already there. .It Sy | Pipe all lines to a shell command and display them without changing them. .El .Pp At any time these single-character commands can also be used: .Bl -tag -width indent .It Aq Sy Tab Move to next input field. .It Aq Sy Return Move to next input field. .It Sy ^n Move to next input field. .It Sy ^p Move to previous input field. .It Sy ^y Search with the last text typed. .It Sy ^b Move to previous input field and search pattern. .It Sy ^f Move to next input field and search pattern. .It Sy ^c Toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .It Sy ^r Rebuild the cross-reference. .It Sy ! Start an interactive shell (type ^d to return to .Nm ). .It Sy ^l Redraw the screen. .It Sy ? Give help information about .Nm commands. .It Sy ^d Exit .Nm .El .Pp NOTE: If the first character of the text to be searched for matches one of the above commands, escape it by typing a \ (backslash) first. .Pp .Ss Substituting new text for old text .Pp After the text to be changed has been typed, .Nm will prompt for the new text, and then it will display the lines containing the old text. Select the lines to be changed with these single-character commands: .Bl -tag -width indent .It 1-9 Mark or unmark the line to be changed. .It * Mark or unmark all displayed lines to be changed. .It Aq Space Display next set of lines. .It + Display next set of lines. .It - Display previous set of lines. .It a Mark or unmark all lines to be changed. .It ^d Change the marked lines and exit. .It Aq Esc Exit without changing the marked lines. .It ! Start an interactive shell (type ^d to return to .Nm ). .It ^l Redraw the screen. .It ? Give help information about .Nm commands. .El .Pp .Ss Special keys .Pp If your terminal has arrow keys that work in vi, you can use them to move around the input fields. The up-arrow key is useful to move to the previous input field instead of using the key repeatedly. If you have , , or keys they will act as the ^l, +, and - commands, respectively. .Pp .Ss Line-Oriented interface .Pp The -l option lets you use .Nm where a screen-oriented interface would not be useful, for example, from another screen-oriented program. .Pp .Nm will prompt with >> when it is ready for an input line starting with the field number (counting from 0) immediately followed by the search pattern, for example, ``lmain'' finds the definition of the main function. .Pp If you just want a single search, instead of the -l option use the -L and -num pattern options, and you won't get the >> prompt. .Pp For -l, .Nm outputs the number of reference lines .Nm : 2 lines .Pp For each reference found, .Nm outputs a line consisting of the file name, function name, line number, and line text, separated by spaces, for example, main.c main 161 main(argc, argv) .Pp Note that the editor is not called to display a single reference, unlike the screen-oriented interface. .Pp You can use the c command to toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .Pp You can use the r command to rebuild the database. .Pp .Nm will quit when it detects end-of-file, or when the first character of an input line is ``^d'' or ``q''. .Pp .Bl -tag -width indent .Ss Environment variables .It Ev EDITOR Preferred editor, which defaults to vi. .It Ev HOME Home directory, which is automatically set at login. .It Ev INCLUDEDIRS Colon-separated list of directories to search for #include files. .It Ev SHELL Preferred shell, which defaults to sh. .It Ev SOURCEDIRS Colon-separated list of directories to search for additional source files. .It Ev TERM Terminal type, which must be a screen terminal. .It Ev TERMINFO Terminal information directory full path name. If your terminal is not in the standard terminfo directory, see curses and terminfo for how to make your own terminal description. .It Ev TMPDIR Temporary file directory, which defaults to /var/tmp. .It Ev VIEWER Preferred file display program (such as less), which overrides EDITOR (see above). .It Ev VPATH A colon-separated list of directories, each of which has the same directory structure below it. If VPATH is set, .Nm searches for source files in the directories specified; if it is not set, .Nm searches only in the current directory. .El .Pp .Ss Files .Bl -tag -width indent .It Em cscope.files Default files containing -I , -p, -q, and -T options and the list of source files (overridden by the -i option). .It Em cscope.out Symbol cross-reference file (overridden by the -f option), which is put in the home directory if it cannot be created in the current directory. .It Em cscope.in.out, cscope.po.out Default files containing the inverted index used for quick symbol searching (-q option). If you use the -f option to rename the cross-reference file (so it's not cscope.out ), the names for these inverted index files will be created by adding .in and .po to the name you supply with -f. For example, if you indicated -f xyz, then these files would be named xyz.in and xyz.po. .It Em INCDIR Standard directory for #include files (usually /usr/include). .El .Pp .Ss Notices .Pp .Nm recognizes function definitions of the form: .Pp fname blank ( args ) white arg_decs white { .Bl -tag -width indent .It Sy where: .It fname is the function name .It blank is zero or more spaces or tabs, not including newlines .It args is any string that does not contain a ``"'' or a newline .It white is zero or more spaces, tabs, or newlines .It arg_decs are zero or more argument declarations (arg_decs may include comments and white space) .El .Pp It is not necessary for a function declaration to start at the beginning of a line. The return type may precede the function name; .Nm will still recognize the declaration. Function definitions that deviate from this form will not be recognized by .Nm .Pp The ``Function'' column of the search output for the menu option Find functions called by this function: input field will only display the first function called in the line, that is, for this function .Bl -inset -offset indent -compact .It e() .It { .It return (f() + g()); .It } .El the display would be: .Bl -inset -offset indent -compact .It Functions called by this function: e .It File Function Line .It a.c f 3 return(f() + g()); .El .Pp Occasionally, a function definition or call may not be recognized because of braces inside #if statements. Similarly, the use of a variable may be incorrectly recognized as a definition. .Pp A typedef name preceding a preprocessor statement will be incorrectly recognized as a global definition, for example, .Bl -inset -offset indent -compact .It LDFILE * .It #if AR16WR .El .Pp Preprocessor statements can also prevent the recognition of a global definition, for example, .Bl -inset -offset indent -compact .It char flag .It #ifdef ALLOCATE_STORAGE .It = -1 .It #endif .It ; .El .Pp A function declaration inside a function is incorrectly recognized as a function call, for example, .Bl -inset -offset indent -compact .It f() .It { .It void g(); .It } .El is incorrectly recognized as a call to g. .Pp .Nm recognizes C++ classes by looking for the class keyword, but doesn't recognize that a struct is also a class, so it doesn't recognize inline member function definitions in a structure. It also doesn't expect the class keyword in a typedef, so it incorrectly recognizes X as a definition in .Bl -inset -offset indent -compact .It typedef class X * Y; .El .Pp It also doesn't recognize operator function definitions .Bl -inset -offset indent -compact .It Bool Feature::operator==(const Feature & other) .It { .It ... .It } .El .Pp Nor does it recognize function definitions with a function pointer argument. .Bl -inset -offset indent -compact .It ParseTable::Recognize(int startState, .It char *pattern, int finishState, .It void (*FinalAction)(char *)) .It { .It ... .It } .El .Sh COPYRIGHT 17 April 2000 The Santa Cruz Operation, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 12: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 0FFFF37B9F2 for ; Sun, 23 Apr 2000 12:20:14 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id MAA34337; Sun, 23 Apr 2000 12:20:08 -0700 (PDT) (envelope-from gnats@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 4BA6F37BA1E for ; Sun, 23 Apr 2000 12:10:43 -0700 (PDT) (envelope-from eogren@rod.darktech.org) Received: from rod.darktech.org (ip254.cambridge2.ma.pub-ip.psi.net [38.32.112.254]) by eagle.prod.itd.earthlink.net (8.9.3/8.9.3) with ESMTP id MAA02635 for ; Sun, 23 Apr 2000 12:10:36 -0700 (PDT) Received: (from eogren@localhost) by rod.darktech.org (8.10.1/8.10.1) id e3NJBnx02584; Sun, 23 Apr 2000 15:11:49 -0400 (EDT) Message-Id: <200004231911.e3NJBnx02584@rod.darktech.org> Date: Sun, 23 Apr 2000 15:11:49 -0400 (EDT) From: eogren@earthlink.net Reply-To: eogren@earthlink.net To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18178: [patch] minor touch-up changing shells section Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18178 >Category: docs >Synopsis: [patch] minor touch-up changing shells section >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: Sun Apr 23 12:20:02 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Eric Ogren >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: FreeBSD rod.darktech.org 4.0-STABLE FreeBSD 4.0-STABLE #3: Tue Apr 4 21:01:56 EDT 2000 eogren@rod.darktech.org:/usr/src/sys/compile/BLUE i386 >Description: A couple of weeks ago, I submitted PR 17862, which added a section to the handbook about changing your shell. I reread the entry today, and I noticed that there are a couple of minor problems; a patch is attached to fix them. >How-To-Repeat: n/a >Fix: Index: chapter.sgml =================================================================== RCS file: /usr/local/doctree/doc/en_US.ISO_8859-1/books/handbook/basics/chapter.sgml,v retrieving revision 1.17 diff -u -r1.17 chapter.sgml --- chapter.sgml 2000/04/10 19:17:16 1.17 +++ chapter.sgml 2000/04/23 19:06:28 @@ -336,15 +336,16 @@ Changing your shell The easiest way to change your shell is to use the - chsh. Running chsh will + chsh command. Running chsh will place you into the editor that is in your EDITOR environment variable; if it is not set, you will be placed in vi. Change the “Shell:” line accordingly. You can also give chsh the - option; this will set the shell for you - without having to enter the editor. For example, if you wanted to + option; this will set your shell for you, + without requiring you to enter an editor. + For example, if you wanted to change your shell to bash, the following should do the trick: >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 Apr 23 13: 1:11 2000 Delivered-To: freebsd-doc@freebsd.org Received: from columbus.cris.net (columbus.cris.net [212.110.128.65]) by hub.freebsd.org (Postfix) with ESMTP id C683C37BA7A; Sun, 23 Apr 2000 13:00:47 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by columbus.cris.net (8.9.3/8.9.3) with UUCP id XAA02986; Sun, 23 Apr 2000 23:00:19 +0300 (EEST) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id WAA12383; Sun, 23 Apr 2000 22:01:52 +0400 (MSD) Date: Sun, 23 Apr 2000 22:01:52 +0400 From: Alexey Zelkin To: John Estess Cc: doc@FreeBSD.ORG, ports@FreeBSD.ORG Subject: Re: cscope man page in text Message-ID: <20000423220152.A12018@scorpion.crimea.ua> Reply-To: Alexey Zelkin References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: X-Operating-System: FreeBSD 2.2.7-RELEASE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Sun, Apr 23, 2000 at 06:23:50PM -0500, John Estess wrote: I suggest to read mdoc(7), mdoc.samples(7) manpages and take a look to /usr/share/examples/mdoc/ > .Op [options] .Op options will be rendered to " [options] " > .Op [file . . . ] Same. It should look like " .Op file... " > .Nm > examines the C (.c and .h), lex (.l), and yacc (.y) source files in the In mdoc terms that sentence should look like: " .Nm examines the C .Pq "\&.c and \&.h" , lex .Pq \&.l , and yacc .Pq \&.y source files in the " > by default, to locate functions, function calls, macros, variables, and > preprocessor symbols in the files. > > .Nm Try to not to use empty lines. You'll get same effect with ".Pp" macro. And it's correct. > ``Issuing Subsequent Requests,'' below.) ``xx'' should be repaced with " .Dq xx " > Look in incdir (before looking in INCDIR, the standard place for header files, > normally > .Pa /usr/include > ) for any #include files whose names do not begin with ``/'' and that are not This ".Pa" case should be changed to: " .Pa /usr/include ) for any ... " > Line-oriented interface (see ``Line-Oriented Interface'' below). ".Dq" again ... > .Nm > , including when you build the cross-reference file, ".Nm" is parsable macro and you can use such combination: " .Nm Ns , " note: Ns -- no space macro. It's just no-op, but useful no-op :) > .Nm > . " .Nm Ns . " > .Pp > The > .Fl I > , > .Fl p > , > .Fl q > , and > .Fl T " .Pp The .Fl I , .Fl p , .Fl q , and .Fl T " looks more elegant, IMHO :) > the -F option. the .Fl F option. > Start an interactive shell (type ^d to return to > .Nm > ). .Nm Ns ) . > escape it by typing a \ (backslash) first. This string will be rendered to " escape it by typing a (backslash) first. " because `\' is escape symbol. You need to replace `\' symbol with `\e'. > with -f. " with .Fl f . " > Standard directory for #include files (usually /usr/include). ^^^^^^^^^^^^ == .Pa > .Sh COPYRIGHT ^^^^^^^^^^^^^ It should be replaced with ".Sh AUTHORS" (by style). > 17 April 2000 The Santa Cruz Operation, Inc. ;-) -- /* Alexey Zelkin && phantom@cris.net */ /* Tavric National University && phantom@crimea.edu */ /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 14:35: 8 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mailgw1.be.to (mailgw1.be.to [210.235.212.5]) by hub.freebsd.org (Postfix) with ESMTP id DA99037B549 for ; Sun, 23 Apr 2000 14:35:04 -0700 (PDT) (envelope-from okazaki@be.to) Received: from mail1.be.to (www.be.to [210.235.212.3]) by mailgw1.be.to (8.9.3+3.2W/BETO.2.1-2000032215000035) with ESMTP id GAA07885 for ; Mon, 24 Apr 2000 06:34:59 +0900 Received: from acidrain (ppp03-Mobara1.mtci.ne.jp [210.172.1.205]) by mail1.be.to (8.8.8+3.0Wbeta13/BETO.2.0-1999110714000000) with SMTP id GAA32007 for ; Mon, 24 Apr 2000 06:34:54 +0900 Received: (qmail 23046 invoked from network); 23 Apr 2000 21:33:12 -0000 Received: from localhost (HELO acidrain.localnet) (127.0.0.1) by localhost with SMTP; 23 Apr 2000 21:33:12 -0000 Date: Mon, 24 Apr 2000 06:33:09 +0900 Message-ID: <86g0scfqp6.wl@dolphin.be.to> From: OKAZAKI Tetsurou To: phantom@cris.crimea.ua Cc: jestess@wcnet.net, doc@FreeBSD.ORG, ports@FreeBSD.ORG Subject: Re: cscope man page in text In-Reply-To: In your message of "Sun, 23 Apr 2000 22:01:52 +0400" <20000423220152.A12018@scorpion.crimea.ua> References: <20000423220152.A12018@scorpion.crimea.ua> User-Agent: Wanderlust/1.1.1 (Purple Rain) REMI/1.14.1 (=?ISO-8859-4?Q?Mus?= =?ISO-8859-4?Q?higawa=F2sugi?=) Chao/1.14.1 (=?ISO-8859-4?Q?Rokujiz=F2?=) APEL/10.2 Emacs/20.6 (i386--freebsd) MULE/4.0 (HANANOEN) Organization: Unknown MIME-Version: 1.0 (generated by REMI 1.14.1 - =?ISO-8859-4?Q?=22Mushigawa=F2?= =?ISO-8859-4?Q?sugi=22?=) Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, In the message <20000423220152.A12018@scorpion.crimea.ua> Alexey Zelkin wrote: > On Sun, Apr 23, 2000 at 06:23:50PM -0500, John Estess wrote: > I suggest to read mdoc(7), mdoc.samples(7) manpages and take a look > to /usr/share/examples/mdoc/ > > .Op [options] > .Op options > will be rendered to > " > [options] > " | .It Fl i namefile | Browse through all source files whose names are listed in namefile It should be .It Fl i Ar namefile Browse through all source files whose names are listed in .Ar namefile > > .Op [file . . . ] > Same. It should look like > " > .Op file... > " " .Op Ar " is better? -- Tetsurou To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 14:46:43 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id 2E55E37B57C; Sun, 23 Apr 2000 14:46:38 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from ec-nortel-0361.wcnet.net [216.88.252.162] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id AF361E601D8; Sun, 23 Apr 2000 16:46:30 -0500 Date: Sun, 23 Apr 2000 16:50:23 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: OKAZAKI Tetsurou Cc: doc@FreeBSD.ORG, ports@FreeBSD.ORG Subject: Re: cscope man page in text In-Reply-To: <86g0scfqp6.wl@dolphin.be.to> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Thank you. > > I suggest to read mdoc(7), mdoc.samples(7) manpages and take a look > > to /usr/share/examples/mdoc/ I did find mdoc and mdoc.samples - I'm rather depressed that it didn't show ;-) Thanks for the pointer to /usr/share/examples/mdoc. I'll try to tweak on it some more, but I'm moving this week, so don't hold your breath. Should I send a pr to do the port? I didn't see it in the pr lists. I appreciate the feedback. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 14:53: 2 2000 Delivered-To: freebsd-doc@freebsd.org Received: from dt051n0b.san.rr.com (dt051n0b.san.rr.com [204.210.32.11]) by hub.freebsd.org (Postfix) with ESMTP id 3178D37B9E1 for ; Sun, 23 Apr 2000 14:52:59 -0700 (PDT) (envelope-from DougB@gorean.org) Received: from gorean.org (doug@master [10.0.0.2]) by dt051n0b.san.rr.com (8.9.3/8.9.3) with ESMTP id OAA10054; Sun, 23 Apr 2000 14:51:57 -0700 (PDT) (envelope-from DougB@gorean.org) Message-ID: <3903707D.D3D7019D@gorean.org> Date: Sun, 23 Apr 2000 14:51:57 -0700 From: Doug Barton Organization: Triborough Bridge & Tunnel Authority X-Mailer: Mozilla 4.72 [en] (X11; U; FreeBSD 5.0-CURRENT-0422 i386) X-Accept-Language: en MIME-Version: 1.0 To: Mike Brown Cc: "'freebsd-doc@FreeBSD.ORG'" Subject: Re: autodection of encoding vs freebsd.org's docs References: <8D96EDA0AC04D31197B400A0C96C1480F705BE@ossex1.ossinc.net> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Mike Brown wrote: > > I have my browser (IE 5.0) set to autodetect encodings of documents, which > seems like a sensible thing to do. Only if you regularly view web pages that have different encodings, and you are equipped to view them properly. > The HTML documents on the freebsd.org site tend to fail to have any encoding > declarations in the HTTP headers (Content-Type: text/html;charset=foo) or in > the document HEAD ( content="text/html;charset=foo">). The web pages should have an ISO encoding stated explicitly in any case. That's the most recent "best practice," related both to the growing internationalization (a good thing, don't get me wrong) and to help combat the cross-domain CGI security problem that was highlighted by CERT recently. The proper format is: Foo Obviously the other charsets for the translated documents should specify their appropriate encoding. (Indenting is of course, optional.) HTH, Doug To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sun Apr 23 17:39: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 CD96937B841; Sun, 23 Apr 2000 17:39:35 -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 BAA43056; Mon, 24 Apr 2000 01:39:12 +0100 (BST) (envelope-from nik) Date: Mon, 24 Apr 2000 01:39:12 +0100 From: Nik Clayton To: Alexander Langer , doc@freebsd.org Cc: Nik Clayton , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: doc/en_US.ISO_8859-1/books/porter-handbook book.sgml Message-ID: <20000424013911.A42855@catkin.nothing-going-on.org> References: <200004222335.QAA55709@freefall.freebsd.org> <20000423130650.A3938@cichlids.cichlids.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000423130650.A3938@cichlids.cichlids.com>; from alex@big.endian.de on Sun, Apr 23, 2000 at 01:06:50PM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sun, Apr 23, 2000 at 01:06:50PM +0200, Alexander Langer wrote: > Thus spake Nik Clayton (nik@FreeBSD.ORG): > > [ thousands of lines deleted ] > > Argl, didn't you say it is EASY for translators to adopt the changes? > ;-) It's really not that tricky. I also think the work is actually language neutral -- if any of the translation teams want me to do it for them, please just let me know. 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 Apr 24 1:46:45 2000 Delivered-To: freebsd-doc@freebsd.org Received: from info.iet.unipi.it (info.iet.unipi.it [131.114.9.184]) by hub.freebsd.org (Postfix) with ESMTP id F298337B628; Mon, 24 Apr 2000 01:45:56 -0700 (PDT) (envelope-from luigi@info.iet.unipi.it) Received: (from luigi@localhost) by info.iet.unipi.it (8.9.3/8.9.3) id KAA13700; Mon, 24 Apr 2000 10:46:31 +0200 (CEST) (envelope-from luigi) From: Luigi Rizzo Message-Id: <200004240846.KAA13700@info.iet.unipi.it> Subject: Re: Draft bridging chapter for handbook In-Reply-To: <4.2.2.20000420122909.039d9140@mail.virtation.com> from Steve Peterson at "Apr 20, 2000 12:34:04 pm" To: Steve Peterson Date: Mon, 24 Apr 2000 10:46:31 +0200 (CEST) Cc: freebsd-doc@FreeBSD.ORG, freebsd-net@FreeBSD.ORG X-Mailer: ELM [version 2.4ME+ PL61 (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 > Having just gone through the work to set up bridging on FreeBSD 4.0, I > thought I'd take a whack at writing a manual section on it. It's at > http://www.virtation.com/home/stevep/freebsd-bridging.txt and I'd > appreciate your feedback. I'm not a subscriber to these lists, so if you > could copy me directly with your comments that would be great. for sure there is a mistake, the kernel option is "BRIDGE" and not "BRIDGING" as you mention. cheers luigi > Steve Peterson > > -- > Steve Peterson +1 952 948 9729 > Principal Consultant FAX +1 612 677 3050 > Virtation Technologies, Inc. http://virtation.com > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-net" 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 Mon Apr 24 11: 0:51 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 5CB3C37BCA1 for ; Mon, 24 Apr 2000 11:00:24 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA72104 for freebsd-doc@freebsd.org; Mon, 24 Apr 2000 11:00:23 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 24 Apr 2000 11:00:23 -0700 (PDT) Message-Id: <200004241800.LAA72104@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Subject: Current unassigned doc problem reports Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Current FreeBSD problem reports The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. Bugs can be in one of several states: o - open A problem report has been submitted, no sanity checking performed. a - analyzed The report has been examined by a team member and evaluated. f - feedback The problem has been solved, and the originator has been given a patch or a fix has been committed. The PR remains in this state pending a response from the originator. s - suspended The problem is not being worked on. This is a prime candidate for somebody who is looking for a project to do. If the problem cannot be solved at all, it will be closed, rather than suspended. c - closed A problem report is closed when any changes have been integrated, documented, and tested. Critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [2000/04/23] docs/18177 doc [Patch] print message was wrong about PC- 1 problem total. Serious problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [2000/02/08] docs/16585 doc no info documentation for nm (binutils) i 1 problem total. Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [1998/09/09] docs/7873 doc poor initial configuration and documentat o [1999/02/25] docs/10240 doc We need a script which check if our web m o [1999/04/07] docs/10997 doc Problem with query-pr-summary.cgi o [1999/08/23] docs/13341 doc FAQ 8.7 addition - booting drive 1 from N o [1999/08/28] docs/13441 doc incorrect path in SGML_CATALOG_FILES env o [1999/08/28] docs/13442 doc docproj-primer does not mention where to o [1999/09/17] docs/13792 doc Difficult to find documentation of "secur o [1999/09/19] docs/13815 doc Out-of-date FAQ entries o [1999/09/25] docs/13950 doc webpage idea o [1999/09/25] docs/13967 doc FreeBSD Related Publications in Korea f [1999/09/29] docs/14035 doc tzfile.h referenced in tzfile(5) doesn't o [1999/10/06] docs/14158 doc md5(1) manpage should not claim the md5 a o [1999/10/25] docs/14532 doc Much of cam_cdbparse(3) prints in Courier o [1999/10/27] docs/14563 doc Wrong manpage produced by `man 4 fd' 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 [1999/12/19] docs/15561 doc regex(3) manpage needs update o [2000/01/01] docs/15821 doc Wrong device names in manpages for lpt(4) o [2000/01/04] docs/15890 doc rfork(RFMEM) on SMP generates error o [2000/01/18] docs/16173 doc [PATCH] fix for the kld/cdev example o [2000/01/29] docs/16439 doc fdp-primer - difficulties with split SGML o [2000/02/23] docs/16934 doc anon transfer log doesn't log all xfers o [2000/02/26] docs/17014 doc send-pr sets MAIL_AGENT unconditionally o [2000/03/01] docs/17101 doc Useless reference in the doscmd manpage o [2000/03/01] docs/17105 doc Wrong crossreference in ndc(8). o [2000/03/08] docs/17269 doc Description of Symbols in nm(1) o [2000/03/13] docs/17364 doc Fix minor errors and omissions in FAQ o [2000/03/18] docs/17469 doc Missing man page: sigwait o [2000/03/18] docs/17470 doc Missing man page: pthread_yield o [2000/03/20] docs/17521 doc Proposed FAQ on assembly programming o [2000/03/21] docs/17544 doc login.conf(5) should have pointer to cap_ o [2000/03/22] docs/17552 doc Documentation error in divert(4) o [2000/03/23] docs/17566 doc [PATCH] ssh(1) and sshd(8) manpage error o [2000/03/25] docs/17598 doc installworld over NFS documentation no lo o [2000/04/03] docs/17780 doc if they ask for smbmount, they want shari o [2000/04/06] docs/17836 doc manpage for sigaction(2) is wrong o [2000/04/07] docs/17855 doc PPP Primer is out-of-date o [2000/04/08] docs/17861 doc FAQ still needs 4.0 inserted in some plac o [2000/04/20] docs/18115 doc Errors in the Pedantic PPP Primer o [2000/04/23] docs/18178 doc [patch] minor touch-up changing shells se 41 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 Apr 24 12:27: 1 2000 Delivered-To: freebsd-doc@freebsd.org Received: from imo16.mx.aol.com (imo16.mx.aol.com [152.163.225.6]) by hub.freebsd.org (Postfix) with ESMTP id ECDAD37BBA1 for ; Mon, 24 Apr 2000 12:26:58 -0700 (PDT) (envelope-from EBaranova@aol.com) Received: from EBaranova@aol.com by imo16.mx.aol.com (mail_out_v25.3.) id n.c5.47fd73b (7944) for ; Mon, 24 Apr 2000 15:26:56 -0400 (EDT) From: EBaranova@aol.com Message-ID: Date: Mon, 24 Apr 2000 15:26:55 EDT Subject: No Subject To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Mailer: AOL for Macintosh sub 146 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org CAn you please let me know how I can get a converter for IMAC. I have aol and also Netscape and Explorer. I need to be able to read Russian websites and write email in Russian. I hope you guys can help. Best Regards Elena BAranova To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Mon Apr 24 17:19: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 A840F37B72B for ; Mon, 24 Apr 2000 17:19:29 -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 AAA10963; Tue, 25 Apr 2000 00:38:10 +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 LAA12113; Mon, 24 Apr 2000 11:11:05 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Mon, 24 Apr 2000 11:11:05 +0100 From: Nik Clayton To: Sheldon Hearn Cc: doc@FreeBSD.org Subject: Re: Plan to incorporate chapter 2 of the 4.4BSD book Message-ID: <20000424111105.B12023@kilt.nothing-going-on.org> References: <93043.955379404@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: <93043.955379404@axl.ops.uunet.co.za>; from sheldonh@uunet.co.za on Mon, Apr 10, 2000 at 05:10:04PM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Apr 10, 2000 at 05:10:04PM +0200, Sheldon Hearn wrote: > A draft copy of the chapter of the 4.4BSD book which we've been given > permission to reproduce is available for examination at: > > http://www.freebsd.org/~sheldonh/design44bsd/ Oh bugger. Threaded mail readers are great, but people will insist on posting replies to threads that have long since scrolled off the top of my window. I've only just seen this. Can you give me a day or two to take a look at it. > I'll ask Addision-Wesley how they feel about this stuff getting onto our > CDROMs. Cheers. > In the mean time, I'd appreciate feedback from anyone who knows about > bits which have changed in FreeBSD which need to be marked as such in > chapter. The idea is that the text describing each changed aspect > should be flagged with a "Changed in FreeBSD" hypertext link into a list > of changes. This has since been changed in FreeBSD. See for more details. Possibly without the surrounding . Then have a Changes in FreeBSD.</para> <formalpara id="aw-changes-foo"> <title>Changes to the Foo Frobnicator FreeBSD now has a unified Foo Frobnication mechanism, which is more efficient than the split scheme described. . . ... (where the 'n' in '' is replaced with an appropriate number). That'd be my first choice. Possibly wrapping an around all the s as well. In this instance they need to be , because they need a title. Without a title, can't generate the text of the link correctly. The alternative would be to use ... see changes to the Foo Frobnicator for more details. [...] FreeBSD now has a unified ... which I don't like as much. I think each change should get its own title -- lets you do that without giving each change its own , which would be overkill IMHO. More info when I've seen the chapter. 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 Tue Apr 25 4:14:50 2000 Delivered-To: freebsd-doc@freebsd.org Received: from tmp.iem.pw.edu.pl (tmp.iem.pw.edu.pl [148.81.77.63]) by hub.freebsd.org (Postfix) with ESMTP id 1957F37BD19 for ; Tue, 25 Apr 2000 04:14:47 -0700 (PDT) (envelope-from szmurlor@tmp.iem.pw.edu.pl) Received: from localhost (szmurlor@localhost) by tmp.iem.pw.edu.pl (8.9.3/8.9.3) with ESMTP id NAA07705 for ; Tue, 25 Apr 2000 13:14:36 +0200 (CEST) (envelope-from szmurlor@tmp.iem.pw.edu.pl) Date: Tue, 25 Apr 2000 13:14:36 +0200 (CEST) From: Robert Szmurlo To: freebsd-doc@FreeBSD.ORG Subject: Polish documentation. Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hallo! I'd like to ask (as it is in handbook) if there is anyone working on polish translation of FreeBSD documentation. If there is anyone please send me amy contact to him. If there is hardly anyone please send me more information. Robert Szmurlo (www.ee.pw.edu.pl/~szmurlor) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 5:25:43 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id C1ADC37BB50 for ; Tue, 25 Apr 2000 05:25:32 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from ec-nortel-0151.wcnet.net [216.88.253.153] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id AEB76BE0218; Tue, 25 Apr 2000 07:25:27 -0500 Date: Tue, 25 Apr 2000 07:29:27 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: doc@freebsd.org Subject: last time for mdoc corrections Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Please help correct these problems: 1) under .Ss Issuing subsequent requests, I end up with the sentence "If the search is..." skipping two lines. Why? How do I stop that from happening? 2) under header Line-Orientated Interface, using .Fl l stops groff in its tracks. How do I mark options later in the page (not in a .It line)? Please test before answering. 3) I need a period after cscope in deviate from this form will not be recognized by .Nm (which is cscope) Yes, I tried .Nm Ns . and .Nm . and .Nm \&. Please help? Thanks. John Estess jestess@wcnet.net .Dd April 22, 2000 .Dt CSCOPE 1 .Os FreeBSD 4.0 .Sh NAME .Nm cscope .Nd interactively examine a C program .Sh SYNOPSIS .Nm cscope .Op options .Op file... .Sh DESCRIPTION .Nm is an interactive, screen-oriented tool that allows the user to browse through C source files for specified elements of code. By default, .Nm examines the C .Pq "\&.c and \&.h" , lex .Pq \&.l , and yacc .Pq \&.y source files in the current directory. .Nm may also be invoked for source files named on the command line. In either case, .Nm searches the standard directories for #include files that it does not find in the current directory. .Nm uses a symbol cross-reference, .Pa cscope.out by default, to locate functions, function calls, macros, variables, and preprocessor symbols in the files. .Pp .Nm builds the symbol cross-reference the first time it is used on the source files for the program being browsed. On a subsequent invocation, .Nm rebuilds the cross-reference only if a source file has changed or the list of source files is different. When the cross-reference is rebuilt, the data for the unchanged files are copied from the old cross-reference, which makes rebuilding faster than the initial build. .Pp The following options can appear in any combination: .Bl -tag -width indent .It Fl b Build the cross-reference only. .It Fl C Ignore letter case when searching. .It Fl c Use only ASCII characters in the cross-reference file, that is, do not compress the data. .It Fl d Do not update the cross-reference. .It Fl e Suppress the -e command prompt between files. .It Fl F Ar symfile Read symbol reference lines from symfile. (A symbol reference file is created by > and >>, and can also be read using the < command, described under .Dq Issuing Subsequent Requests, below.) .It Fl f Ar reffile Use reffile as the cross-reference file name instead of the default .Pa cscope.out . .It Fl I Ar incdir Look in incdir (before looking in INCDIR, the standard place for header files, normally .Pa /usr/include ) for any #include files whose names do not begin with ``/'' and that are not specified on the command line or in namefile below. (The #include files may be specified with either double quotes or angle brackets.) The incdir directory is searched in addition to the current directory (which is searched first) and the standard list (which is searched last). If more than one occurrence of .Fl I appears, the directories are searched in the order they appear on the command line. .It Fl i Ar namefile Browse through all source files whose names are listed in namefile .Pq file names separated by spaces, tabs, or new-lines instead of the default .Pq Pa cscope.files . If this option is specified, .Nm ignores any files appearing on the command line. .It Fl L Do a single search with line-oriented output when used with the .Fl num pattern option. .It Fl l Line-oriented interface (see .Dq Line-Oriented Interface below). .It Fl num Ar pattern Go to input field num (counting from 0) and find pattern. .It Fl P Ar path Prepend path to relative file names in a pre-built cross-reference file so you do not have to change to the directory where the cross-reference file was built. This option is only valid with the .Fl d option. .It Fl p Ar n Display the last .Sy n file path components instead of the default (1). Use 0 to not display the file name at all. .It Fl q Build an inverted index for quick symbol searching. If you use this option with the .Fl f option, you must use .Fl f on every call to .Nm Ns , including when you build the cross-reference file, because it changes the names of the inverted index files. .It Fl s Ar dir Look in dir for additional source files. This option is ignored if source files are given on the command line. .It Fl T Use only the first eight characters to match against C symbols. A regular expression containing special characters other than a period (.) will not match any symbol if its minimum length is greater than eight characters. .It Fl U Check file time stamps. This option will update the time stamp on the database even if no files have changed. .It Fl u Unconditionally build the cross-reference file (assume that all files have changed). .It Fl V Print on the first line of screen the version number of .Nm Ns . .Pp The .Fl I , .Fl p , .Fl q , and .Fl T options can also be in the .Pa cscope.files file. .El .Pp .Ss Requesting the initial search .Pp After the cross-reference is ready, .Nm will display this menu: .Pp .Bl -inset -offset -indent -compact .It Find this C symbol: .It Find this function definition: .It Find functions called by this function: .It Find functions calling this function: .It Find this text string: .It Change this text string: .It Find this egrep pattern: .It Find this file: .It Find files #including this file: .El .Pp Press the key repeatedly to move to the desired input field, type the text to search for, and then press the key. .Pp .Ss Issuing subsequent requests .Pp Ns If the search is successful, any of these single-charactor commands can be used: .Bl -tag -width -offset indent .It Sy 1-9 Edit the file referenced by the given line number. .It Aq Sy Space Display next set of matching lines. .It Sy + Display next set of matching lines. .It Sy - Display previous set of matching lines. .It Sy ^e Edit displayed files in order. .It Sy > Write the displayed list of lines to a file. .It Sy >> Append the displayed list of lines to a file. .It Sy < Read lines from a file that is in symbol reference format (created by > or >>), just like the -F option. .It Sy ^ Filter all lines through a shell command and display the resulting lines, replacing the lines that were already there. .It Sy | Pipe all lines to a shell command and display them without changing them. .El .Pp At any time these single-character commands can also be used: .Bl -tag -width -offset indent .It Aq Sy Tab Move to next input field. .It Aq Sy Return Move to next input field. .It Sy ^n Move to next input field. .It Sy ^p Move to previous input field. .It Sy ^y Search with the last text typed. .It Sy ^b Move to previous input field and search pattern. .It Sy ^f Move to next input field and search pattern. .It Sy ^c Toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .It Sy ^r Rebuild the cross-reference. .It Sy ! Start an interactive shell (type ^d to return to .Nm ). .It Sy ^l Redraw the screen. .It Sy ? Give help information about .Nm commands. .It Sy ^d Exit .Nm .El .Pp NOTE: If the first character of the text to be searched for matches one of the above commands, escape it by typing a \e (backslash) first. .Pp .Ss Substituting new text for old text .Pp After the text to be changed has been typed, .Nm will prompt for the new text, and then it will display the lines containing the old text. Select the lines to be changed with these single-character commands: .Bl -tag -width x -indent .It 1-9 Mark or unmark the line to be changed. .It * Mark or unmark all displayed lines to be changed. .It Aq Space Display next set of lines. .It + Display next set of lines. .It - Display previous set of lines. .It a Mark or unmark all lines to be changed. .It \^d Change the marked lines and exit. .It Aq Esc Exit without changing the marked lines. .It ! Start an interactive shell (type ^d to return to .Nm ). .It ^l Redraw the screen. .It ? Give help information about .Nm commands. .El .Pp .Ss Special keys .Pp If your terminal has arrow keys that work in vi, you can use them to move around the input fields. The up-arrow key is useful to move to the previous input field instead of using the key repeatedly. If you have , , or keys they will act as the ^l, +, and - commands, respectively. .Pp .Ss Line-Oriented interface .Pp The -l option lets you use .Nm where a screen-oriented interface would not be useful, for example, from another screen-oriented program. .Pp .Nm will prompt with >> when it is ready for an input line starting with the field number (counting from 0) immediately followed by the search pattern, for example, ``lmain'' finds the definition of the main function. .Pp If you just want a single search, instead of the -l option use the -L and -num pattern options, and you won't get the >> prompt. .Pp For -l, .Nm outputs the number of reference lines .Nm : 2 lines .Pp For each reference found, .Nm outputs a line consisting of the file name, function name, line number, and line text, separated by spaces, for example, main.c main 161 main(argc, argv) .Pp Note that the editor is not called to display a single reference, unlike the screen-oriented interface. .Pp You can use the c command to toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .Pp You can use the r command to rebuild the database. .Pp .Nm will quit when it detects end-of-file, or when the first character of an input line is ``^d'' or ``q''. .Pp .Ss Environment variables .Bl -tag -width INCLUDEDIRSx -indent .It Ev EDITOR Preferred editor, which defaults to vi. .It Ev HOME Home directory, which is automatically set at login. .It Ev INCLUDEDIRS Colon-separated list of directories to search for #include files. .It Ev SHELL Preferred shell, which defaults to sh. .It Ev SOURCEDIRS Colon-separated list of directories to search for additional source files. .It Ev TERM Terminal type, which must be a screen terminal. .It Ev TERMINFO Terminal information directory full path name. If your terminal is not in the standard terminfo directory, see curses and terminfo for how to make your own terminal description. .It Ev TMPDIR Temporary file directory, which defaults to /var/tmp. .It Ev VIEWER Preferred file display program (such as less), which overrides EDITOR (see above). .It Ev VPATH A colon-separated list of directories, each of which has the same directory structure below it. If VPATH is set, .Nm searches for source files in the directories specified; if it is not set, .Nm searches only in the current directory. .El .Pp .Ss Files .Bl -tag -width indent .It Em cscope.files Default files containing -I , -p, -q, and -T options and the list of source files (overridden by the -i option). .It Em cscope.out Symbol cross-reference file (overridden by the -f option), which is put in the home directory if it cannot be created in the current directory. .It Em cscope.in.out, cscope.po.out Default files containing the inverted index used for quick symbol searching (-q option). If you use the -f option to rename the cross-reference file (so it's not cscope.out ), the names for these inverted index files will be created by adding .in and .po to the name you supply with -f. For example, if you indicated -f xyz, then these files would be named xyz.in and xyz.po. .It Em INCDIR Standard directory for #include files (usually /usr/include). .El .Pp .Ss Notices .Pp .Nm recognizes function definitions of the form: .Pp fname blank ( args ) white arg_decs white { .Bl -tag -width indent .It Sy where: .It fname is the function name .It blank is zero or more spaces or tabs, not including newlines .It args is any string that does not contain a ``"'' or a newline .It white is zero or more spaces, tabs, or newlines .It arg_decs are zero or more argument declarations (arg_decs may include comments and white space) .El .Pp It is not necessary for a function declaration to start at the beginning of a line. The return type may precede the function name; .Nm will still recognize the declaration. Function definitions that deviate from this form will not be recognized by .Nm .Pp The ``Function'' column of the search output for the menu option Find functions called by this function: input field will only display the first function called in the line, that is, for this function .Bl -inset -offset indent -compact .It e() .It { .It return (f() + g()); .It } .El the display would be: .Bl -inset -offset indent -compact .It Functions called by this function: e .It File Function Line .It a.c f 3 return(f() + g()); .El .Pp Occasionally, a function definition or call may not be recognized because of braces inside #if statements. Similarly, the use of a variable may be incorrectly recognized as a definition. .Pp A typedef name preceding a preprocessor statement will be incorrectly recognized as a global definition, for example, .Bl -inset -offset indent -compact .It LDFILE * .It #if AR16WR .El .Pp Preprocessor statements can also prevent the recognition of a global definition, for example, .Bl -inset -offset indent -compact .It char flag .It #ifdef ALLOCATE_STORAGE .It = -1 .It #endif .It ; .El .Pp A function declaration inside a function is incorrectly recognized as a function call, for example, .Bl -inset -offset indent -compact .It f() .It { .It void g(); .It } .El is incorrectly recognized as a call to g. .Pp .Nm recognizes C++ classes by looking for the class keyword, but doesn't recognize that a struct is also a class, so it doesn't recognize inline member function definitions in a structure. It also doesn't expect the class keyword in a typedef, so it incorrectly recognizes X as a definition in .Bl -inset -offset indent -compact .It typedef class X * Y; .El .Pp It also doesn't recognize operator function definitions .Bl -inset -offset indent -compact .It Bool Feature::operator==(const Feature & other) .It { .It ... .It } .El .Pp Nor does it recognize function definitions with a function pointer argument. .Bl -inset -offset indent -compact .It ParseTable::Recognize(int startState, .It char *pattern, int finishState, .It void (*FinalAction)(char *)) .It { .It ... .It } .El .Sh COPYRIGHT 17 April 2000 The Santa Cruz Operation, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 5:48:22 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.1.175]) by hub.freebsd.org (Postfix) with ESMTP id 2455837B737 for ; Tue, 25 Apr 2000 05:48:11 -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 12k4l0-000NaB-00; Tue, 25 Apr 2000 14:48:02 +0200 From: Sheldon Hearn To: John Estess Cc: doc@FreeBSD.ORG Subject: Re: last time for mdoc corrections In-reply-to: Your message of "Tue, 25 Apr 2000 07:29:27 EST." Date: Tue, 25 Apr 2000 14:48:02 +0200 Message-ID: <90654.956666882@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, 25 Apr 2000 07:29:27 EST, John Estess wrote: > 1) under .Ss Issuing subsequent requests, I end up with the sentence "If > the search is..." skipping two lines. Why? How do I stop that from > happening? I'm pretty sure that this only happens in the ASCII output. If it happens in the PostScript output, it's a real problem. Otherwise, it's just a cosmetic annoyance in groff (I suspect). By the way, section and subsection cross-references can be marked up with Sx instead of Dq. Also, take out the Ns following the Pp -- it's unnecessary. > 2) under header Line-Orientated Interface, using > .Fl l stops groff in its tracks. How do I mark options later in the > page (not in a .It line)? Please test before answering. No error output? The version you sent doesn't use the Fl macro, so I can't see the problem. Certainly, when I use the Fl macro myself, it renders as expected. > 3) I need a period after cscope in > deviate from this form will not be recognized by > .Nm (which is cscope) > Yes, I tried .Nm Ns . and .Nm . and .Nm \&. The construct .Nm Ns . is correct and works perfectly, provided the first instance of the Nm macro specified an argument as yours does. Since you haven't sent a version in which you tried that, I can't tell you more. Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 6:45:49 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mppsystems.com (mppsystems.com [208.210.148.205]) by hub.freebsd.org (Postfix) with ESMTP id 3BA5A37B6B3 for ; Tue, 25 Apr 2000 06:45:45 -0700 (PDT) (envelope-from mpp@mppsystems.com) Received: (from mpp@localhost) by mppsystems.com (8.9.3/8.9.3) id IAA50382; Tue, 25 Apr 2000 08:45:42 -0500 (CDT) (envelope-from mpp) Date: Tue, 25 Apr 2000 08:45:42 -0500 From: Mike Pritchard To: John Estess Cc: doc@FreeBSD.ORG Subject: Re: last time for mdoc corrections Message-ID: <20000425084542.A50322@mppsystems.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: ; from jestess@wcnet.net on Tue, Apr 25, 2000 at 07:29:27AM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Apr 25, 2000 at 07:29:27AM -0500, John Estess wrote: > > Please help correct these problems: > > 1) under .Ss Issuing subsequent requests, I end up with the sentence "If > the search is..." skipping two lines. Why? How do I stop that from > happening? I think this is just a bladly placed page break :-(. > 2) under header Line-Orientated Interface, using > .Fl l stops groff in its tracks. How do I mark options later in the > page (not in a .It line)? Please test before answering. > > 3) I need a period after cscope in > deviate from this form will not be recognized by > .Nm (which is cscope) > Yes, I tried .Nm Ns . and .Nm . and .Nm \&. Items 2 and 3 were both being caused by a bad list. In one section you are using .Bl (begin list) to define a literal table of text. The .Bd (begin display) macro is better suited for this. The attached patch fixes this, and one spelling problem and one minor mdoc nit. If you had redirected stderr when trying to use the .Fl macro (and some variations of .Nm), you would have noticed the groff generated one error, which is what clued me in that there was probably a table/some macro that didn't properly clean itself up. I also noticed that you have a lot of trailing whitespace on some of the macro calls. These should probably be trimmed (I didn't do so in my patch, so that it would be obvious what I really changed). Note: I might have missed some places where you wanted to use .Fl, but couldn't because groff was croaking due to the table problem. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com --- cscope.1.orig Tue Apr 25 08:21:39 2000 +++ cscope.1 Tue Apr 25 08:33:49 2000 @@ -153,34 +153,24 @@ .Nm will display this menu: .Pp -.Bl -inset -offset -indent -compact -.It +.Bd -literal -offset indent Find this C symbol: -.It Find this function definition: -.It Find functions called by this function: -.It Find functions calling this function: -.It Find this text string: -.It Change this text string: -.It Find this egrep pattern: -.It Find this file: -.It Find files #including this file: -.El +.Ed .Pp Press the key repeatedly to move to the desired input field, type the text to search for, and then press the key. -.Pp +.Pp .Ss Issuing subsequent requests -.Pp Ns -If the search is successful, -any of these single-charactor commands can be used: +.Pp +If the search is successful, any of these single-character commands can be used: .Bl -tag -width -offset indent .It Sy 1-9 Edit the file referenced by the given line number. @@ -229,8 +219,7 @@ Rebuild the cross-reference. .It Sy ! Start an interactive shell (type ^d to return to -.Nm -). +.Nm Ns ) . .It Sy ^l Redraw the screen. .It Sy ? @@ -273,8 +262,7 @@ .It ! Start an interactive shell (type ^d to return to -.Nm -). +.Nm Ns ) . .It ^l Redraw the screen. .It ? @@ -293,7 +281,9 @@ .Pp .Ss Line-Oriented interface .Pp -The -l option lets you use +The +.Fl l +option lets you use .Nm where a screen-oriented interface would not be useful, for example, from another screen-oriented program. @@ -304,10 +294,16 @@ search pattern, for example, ``lmain'' finds the definition of the main function. .Pp -If you just want a single search, instead of the -l option use the -L -and -num pattern options, and you won't get the >> prompt. +If you just want a single search, instead of the +.Fl l +option use the +.Fl L +and +.Fl num +pattern options, and you won't get the >> prompt. .Pp -For -l, +For +.Fl l , .Nm outputs the number of reference lines .Nm @@ -354,7 +350,9 @@ Temporary file directory, which defaults to /var/tmp. .It Ev VIEWER Preferred file display program (such as less), -which overrides EDITOR (see above). +which overrides +.Ev EDITOR +(see above). .It Ev VPATH A colon-separated list of directories, each of which has the same directory structure below it. If VPATH is set, To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 8:23:41 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 3B29637BD45; Tue, 25 Apr 2000 08:23:40 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Received: (from sheldonh@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA82437; Tue, 25 Apr 2000 08:23:40 -0700 (PDT) (envelope-from sheldonh@FreeBSD.org) Date: Tue, 25 Apr 2000 08:23:40 -0700 (PDT) From: Message-Id: <200004251523.IAA82437@freefall.freebsd.org> To: josh@zcompany.com, sheldonh@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/7873: poor initial configuration and documentation of kernel resources frustrating! Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: poor initial configuration and documentation of kernel resources frustrating! State-Changed-From-To: open->closed State-Changed-By: sheldonh State-Changed-When: Tue Apr 25 08:17:21 PDT 2000 State-Changed-Why: Lots of discussion, yet this PR hasn't managed to collect any patches in 18 month. This PR enjoys the proud distinction of being the first WishList entry. The new "wish" class is intended for those souls who would like to trawl the PR database for PRs that contain good or interesting ideas that lack useful material with which to implement them. Should you come up with patches and/or new documents to be used in graduating this PR from a wish to a fix, please bug the person or mailing list reflected in the "Responsible" field, asking him, her or them to re-open the PR and change the Class back to "change-request". To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 8:55:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.1.175]) by hub.freebsd.org (Postfix) with ESMTP id AF70737B7BD; Tue, 25 Apr 2000 08:55:33 -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 12k7f4-000Nwi-00; Tue, 25 Apr 2000 17:54:06 +0200 From: Sheldon Hearn To: Soren Schmidt Cc: sos@FreeBSD.org, doc@FreeBSD.org Subject: Re: cvs commit: src/sys/dev/ata ata-all.c ata-all.h ata-dma.c In-reply-to: Your message of "Mon, 10 Apr 2000 10:33:47 +0200." <200004100833.KAA77185@freebsd.dk> Date: Tue, 25 Apr 2000 17:54:06 +0200 Message-ID: <92051.956678046@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, 10 Apr 2000 10:33:47 +0200, Soren Schmidt wrote: > > > Modified files: > > > sys/dev/ata ata-all.c ata-all.h ata-dma.c > > > Log: > > > Add support for ATA66 on newer revisions of the VIA 82C596 > > > > Is this worthy of the release notes? > > Sure, if it turns out it works for everybody (it should)... Any feedback thus far? Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 9:40:15 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.1.175]) by hub.freebsd.org (Postfix) with ESMTP id 17A9837BF06 for ; Tue, 25 Apr 2000 09:40:11 -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 12k8Nc-000O5U-00 for freebsd-doc@FreeBSD.org; Tue, 25 Apr 2000 18:40:08 +0200 From: Sheldon Hearn To: freebsd-doc@FreeBSD.org Subject: Re: docs/7873: poor initial configuration and documentation of kernel resources frustrating! In-reply-to: Your message of "Tue, 25 Apr 2000 08:23:40 MST." <200004251523.IAA82437@freefall.freebsd.org> Date: Tue, 25 Apr 2000 18:40:08 +0200 Message-ID: <92595.956680808@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, 25 Apr 2000 08:23:40 MST, sheldonh@FreeBSD.org wrote: > This PR enjoys the proud distinction of being the first WishList > entry. The new "wish" class is intended for those souls who > would like to trawl the PR database for PRs that contain good > or interesting ideas that lack useful material with which to > implement them. Hmmm... edit-pr(1) didn't ask me why I changed the Class. I expected it to. Note to other PR workers -- please hold off on fiddling with the "wish" class until this is sorted out. Thanks, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 10: 8:13 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 CBB9437BDAC for ; Tue, 25 Apr 2000 10:08: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 8DB465A581 for ; Tue, 25 Apr 2000 14:07:07 -0300 (EST) Content-Length: 935 Message-ID: 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 Date: Tue, 25 Apr 2000 14:07:42 -0300 (EST) From: Carlos Eduardo Selonke de Souza To: freebsd-doc@freebsd.org Subject: style guide - indentation Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello We are starting a team to translate FreeBSD documentation to Brasilian Portuguese. I have some doubts in the FreeBSD Documentation Project Primer, chapter 9 Writing Style, section 9.1.2 Indentation. It says that I can set my XEmacs to automatically use indentation styles. Well, I do not know how to set up my XEmacs, to automatically set indentat ion style. Im using XEmacs+PSGML, I have "everything working" just fine (tag completation, diferent color for tags and text , auto DTD insert), but I dont know how to make this indentation style works. Should I set something in my .emacs (I belive it so), but what variable(s)? Any help would be welcome. Thanks Carlos Eduardo Selonke de Souza mailto:cess@matrix.com.br -----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++ 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 Tue Apr 25 11:31:39 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 95AB137B613; Tue, 25 Apr 2000 11:31:38 -0700 (PDT) (envelope-from jim@FreeBSD.org) Received: (from jim@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id LAA03970; Tue, 25 Apr 2000 11:31:38 -0700 (PDT) (envelope-from jim@FreeBSD.org) Date: Tue, 25 Apr 2000 11:31:38 -0700 (PDT) From: Message-Id: <200004251831.LAA03970@freefall.freebsd.org> To: eogren@earthlink.net, jim@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/18178: [patch] minor touch-up changing shells section Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: [patch] minor touch-up changing shells section State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Tue Apr 25 11:31:21 PDT 2000 State-Changed-Why: Committed, thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 12:35:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freebsd.dk (freebsd.dk [212.242.42.178]) by hub.freebsd.org (Postfix) with ESMTP id A9F0E37B8B0; Tue, 25 Apr 2000 12:35:34 -0700 (PDT) (envelope-from sos@freebsd.dk) Received: (from sos@localhost) by freebsd.dk (8.9.3/8.9.1) id VAA34395; Tue, 25 Apr 2000 21:35:22 +0200 (CEST) (envelope-from sos) From: Soren Schmidt Message-Id: <200004251935.VAA34395@freebsd.dk> Subject: Re: cvs commit: src/sys/dev/ata ata-all.c ata-all.h ata-dma.c In-Reply-To: <92051.956678046@axl.ops.uunet.co.za> from Sheldon Hearn at "Apr 25, 2000 05:54:06 pm" To: sheldonh@uunet.co.za (Sheldon Hearn) Date: Tue, 25 Apr 2000 21:35:21 +0200 (CEST) Cc: sos@FreeBSD.org, doc@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL54 (25)] 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 It seems Sheldon Hearn wrote: > > > > Modified files: > > > > sys/dev/ata ata-all.c ata-all.h ata-dma.c > > > > Log: > > > > Add support for ATA66 on newer revisions of the VIA 82C596 > > > > > > Is this worthy of the release notes? > > > > Sure, if it turns out it works for everybody (it should)... > > Any feedback thus far? Nope, so if no news is good news :) I think there are possibly other chipsets missing from the release notes, I think I added other without updating it... -Søren To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 12:57:20 2000 Delivered-To: freebsd-doc@freebsd.org Received: from teapot27.domain5.bigpond.com (teapot27.domain5.bigpond.com [139.134.5.174]) by hub.freebsd.org (Postfix) with SMTP id 66E7937BD75 for ; Tue, 25 Apr 2000 12:57:17 -0700 (PDT) (envelope-from Mafiouso@most-wanted.com) Received: from localhost (localhost [127.0.0.1]) by teapot27.domain5.bigpond.com (NTMail 3.02.13) with ESMTP id fa862607 for ; Wed, 26 Apr 2000 05:46:59 +1000 Received: from DC-56-16.bpb.bigpond.com ([203.40.56.16]) by mail5.bigpond.com (Claudes-Woozy-MailRouter V2.7e 9/9779624); 26 Apr 2000 05:46:58 From: "$ Mafiouso" To: "doc@freebsd.org" Date: Wed, 26 Apr 2000 05:36:50 +1000 Subject: You Gota See! Reply-To: Mafiouso@most-wanted.com Organization: Mafiouso Inc. MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 7bit X-Priority: 1 Message-Id: <19465945903753@domain5.bigpond.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org $ Hey! $ Check Out This: http://mafiouso3.tripod.com $ The Best In Everything Mp3s, Pictures, Movies What Ever Your After You Will Find It Here, $ Want a HOT Christina Aguilera Background For Your PC $ Just Goto The Link Below And Right Click, Then `SET AS WALLPAPER. http://mafiouso3.tripod.com/Christina.jpg :) Remember It's Da A Hit! $ Contact Mafiouso At: $ ICQ 53709750 $ Email mafiouso@most-wanted.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 14:10: 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 E96A237B5B2 for ; Tue, 25 Apr 2000 14:10:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id OAA20508; Tue, 25 Apr 2000 14:10:00 -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 2A27B37BE14 for ; Tue, 25 Apr 2000 14:00:55 -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.12 #1) id 12kBxf-0002CO-00 for FreeBSD-gnats-submit@freebsd.org; Tue, 25 Apr 2000 21:29:35 +0100 Received: (from ben) by magnesium.scientia.demon.co.uk (Exim 3.12 #1) id 12kBxf-000FDS-00 for FreeBSD-gnats-submit@freebsd.org; Tue, 25 Apr 2000 21:29:35 +0100 Message-Id: Date: Tue, 25 Apr 2000 21:29:35 +0100 From: Ben Smithurst Reply-To: ben@scientia.demon.co.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18214: minor errors in sched_get_priority_max(2) manual page Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18214 >Category: docs >Synopsis: minor errors in sched_get_priority_max(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: Tue Apr 25 14:10:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Ben Smithurst >Release: FreeBSD 3.4-STABLE i386 >Organization: >Environment: FreeBSD magnesium.scientia.demon.co.uk 3.4-STABLE FreeBSD 3.4-STABLE #35: Fri Mar 24 19:59:34 GMT 2000 ben@magnesium.scientia.demon.co.uk:/usr/src/sys/compile/MAGNESIUM i386 >Description: The sched_get_priority_max(2) contains a typo: 'respectfully' should read 'respectively' I think. The patch also uses the correct macro to specify a function argument, which was not used before. >How-To-Repeat: >Fix: Index: sched_get_priority_max.2 =================================================================== RCS file: /usr/cvs/src/lib/libc/sys/sched_get_priority_max.2,v retrieving revision 1.4 diff -u -r1.4 sched_get_priority_max.2 --- sched_get_priority_max.2 2000/04/21 09:42:00 1.4 +++ sched_get_priority_max.2 2000/04/25 20:25:56 @@ -46,8 +46,10 @@ .Fn sched_get_priority_max and .Fn sched_get_priority_min -functions return the appropriate maximum or minimum, respectfully, -for the scheduling policy specified by policy. The +functions return the appropriate maximum or minimum, respectively, +for the scheduling policy specified by +.Fa policy . +The .Fn sched_rr_get_interval function updates the .Fa timespec >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 14:17:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id 1A4DE37BA4E for ; Tue, 25 Apr 2000 14:17:04 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from ec-nortel-0026.wcnet.net [216.88.253.28] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id AB442602CE; Tue, 25 Apr 2000 16:16:52 -0500 Date: Tue, 25 Apr 2000 16:20:53 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: Mike Pritchard Cc: doc@freebsd.org, sheldonh@uunet.co.za, petr@users.sourceforge.net, obrien@NUXI.com Subject: Re: last time for mdoc corrections In-Reply-To: <20000425084542.A50322@mppsystems.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I lied - since there were so many corrections and suggestions, I'm reposting the whole whopper again. If this is a violation of the list, please tell me. It's not as if doc@ is burning up disk space. I just don't want to anger the guys paying by the byte. > If you had redirected stderr when trying to use > the .Fl macro (and some variations of .Nm), you would have noticed > the groff generated one error, which is what clued me in that > there was probably a table/some macro that didn't properly clean itself up. Doh. Stderr? ;-) Fixed that. > I also noticed that you have a lot of trailing whitespace on some > of the macro calls. Fixed that too. > > Note: I might have missed some places where you wanted to use > .Fl, but couldn't because groff was croaking due to the table > problem. I might have even fixed all of those. Thank you to everybody. That was almost fun. :-) ___________________________________________________________________ .Dd April 22, 2000 .Dt CSCOPE 1 .Os FreeBSD 4.0 .Sh NAME .Nm cscope .Nd interactively examine a C program .Sh SYNOPSIS .Nm cscope .Op options .Op file... .Sh DESCRIPTION .Nm is an interactive, screen-oriented tool that allows the user to browse through C source files for specified elements of code. .Pp By default, .Nm examines the C .Pq "\&.c and \&.h" , lex .Pq \&.l , and yacc .Pq \&.y source files in the current directory. .Nm may also be invoked for source files named on the command line. In either case, .Nm searches the standard directories for #include files that it does not find in the current directory. .Nm uses a symbol cross-reference, .Pa cscope.out by default, to locate functions, function calls, macros, variables, and preprocessor symbols in the files. .Pp .Nm builds the symbol cross-reference the first time it is used on the source files for the program being browsed. On a subsequent invocation, .Nm rebuilds the cross-reference only if a source file has changed or the list of source files is different. When the cross-reference is rebuilt, the data for the unchanged files are copied from the old cross-reference, which makes rebuilding faster than the initial build. .Pp The following options can appear in any combination: .Bl -tag -width indent .It Fl b Build the cross-reference only. .It Fl C Ignore letter case when searching. .It Fl c Use only ASCII characters in the cross-reference file, that is, do not compress the data. .It Fl d Do not update the cross-reference. .It Fl e Suppress the -e command prompt between files. .It Fl F Ar symfile Read symbol reference lines from symfile. (A symbol reference file is created by > and >>, and can also be read using the < command, described under .Dq Issuing Subsequent Requests, below.) .It Fl f Ar reffile Use reffile as the cross-reference file name instead of the default .Pa cscope.out . .It Fl I Ar incdir Look in incdir (before looking in INCDIR, the standard place for header files, normally .Pa /usr/include ) for any #include files whose names do not begin with ``/'' and that are not specified on the command line or in namefile below. (The #include files may be specified with either double quotes or angle brackets.) The incdir directory is searched in addition to the current directory (which is searched first) and the standard list (which is searched last). If more than one occurrence of .Fl I appears, the directories are searched in the order they appear on the command line. .It Fl i Ar namefile Browse through all source files whose names are listed in namefile .Pq file names separated by spaces, tabs, or new-lines instead of the default .Pq Pa cscope.files . If this option is specified, .Nm ignores any files appearing on the command line. .It Fl L Do a single search with line-oriented output when used with the .Fl num pattern option. .It Fl l Line-oriented interface (see .Dq Line-Oriented Interface below). .It Fl num Ar pattern Go to input field num (counting from 0) and find pattern. .It Fl P Ar path Prepend path to relative file names in a pre-built cross-reference file so you do not have to change to the directory where the cross-reference file was built. This option is only valid with the .Fl d option. .It Fl p Ar n Display the last .Sy n file path components instead of the default (1). Use 0 to not display the file name at all. .It Fl q Build an inverted index for quick symbol searching. If you use this option with the .Fl f option, you must use .Fl f on every call to .Nm Ns , including when you build the cross-reference file, because it changes the names of the inverted index files. .It Fl s Ar dir Look in dir for additional source files. This option is ignored if source files are given on the command line. .It Fl T Use only the first eight characters to match against C symbols. A regular expression containing special characters other than a period (.) will not match any symbol if its minimum length is greater than eight characters. .It Fl U Check file time stamps. This option will update the time stamp on the database even if no files have changed. .It Fl u Unconditionally build the cross-reference file (assume that all files have changed). .It Fl V Print on the first line of screen the version number of .Nm Ns . .Pp The .Fl I , .Fl p , .Fl q , and .Fl T options can also be in the .Pa cscope.files file. .El .Pp .Ss Requesting the initial search .Pp After the cross-reference is ready, .Nm will display this menu: .Pp .Bd -literal -offset indent Find this C symbol: Find this function definition: Find functions called by this function: Find functions calling this function: Find this text string: Change this text string: Find this egrep pattern: Find this file: Find files #including this file: .Ed .Pp Press the key repeatedly to move to the desired input field, type the text to search for, and then press the key. .Pp .Ss Issuing subsequent requests .Pp If the search is successful, any of these single-character commands can be used: .Bl -tag -width -offset indent .It Sy 1-9 Edit the file referenced by the given line number. .It Aq Sy Space Display next set of matching lines. .It Sy + Display next set of matching lines. .It Sy - Display previous set of matching lines. .It Sy ^e Edit displayed files in order. .It Sy > Write the displayed list of lines to a file. .It Sy >> Append the displayed list of lines to a file. .It Sy < Read lines from a file that is in symbol reference format (created by > or >>), just like the -F option. .It Sy ^ Filter all lines through a shell command and display the resulting lines, replacing the lines that were already there. .It Sy | Pipe all lines to a shell command and display them without changing them. .El .Pp At any time these single-character commands can also be used: .Bl -tag -width -offset indent .It Aq Sy Tab Move to next input field. .It Aq Sy Return Move to next input field. .It Sy ^n Move to next input field. .It Sy ^p Move to previous input field. .It Sy ^y Search with the last text typed. .It Sy ^b Move to previous input field and search pattern. .It Sy ^f Move to next input field and search pattern. .It Sy ^c Toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .It Sy ^r Rebuild the cross-reference. .It Sy ! Start an interactive shell (type ^d to return to .Nm Ns ) . .It Sy ^l Redraw the screen. .It Sy ? Give help information about .Nm commands. .It Sy ^d Exit .Nm .El .Pp NOTE: If the first character of the text to be searched for matches one of the above commands, escape it by typing a \e (backslash) first. .Pp .Ss Substituting new text for old text .Pp After the text to be changed has been typed, .Nm will prompt for the new text, and then it will display the lines containing the old text. Select the lines to be changed with these single-character commands: .Bl -tag -width x -indent .It 1-9 Mark or unmark the line to be changed. .It * Mark or unmark all displayed lines to be changed. .It Aq Space Display next set of lines. .It + Display next set of lines. .It - Display previous set of lines. .It a Mark or unmark all lines to be changed. .It \^d Change the marked lines and exit. .It Aq Esc Exit without changing the marked lines. .It ! Start an interactive shell (type ^d to return to .Nm Ns ) . .It ^l Redraw the screen. .It ? Give help information about .Nm commands. .El .Pp .Ss Special keys .Pp If your terminal has arrow keys that work in vi, you can use them to move around the input fields. The up-arrow key is useful to move to the previous input field instead of using the key repeatedly. If you have , , or keys they will act as the ^l, +, and - commands, respectively. .Pp .Ss Line-Oriented interface .Pp The .Fl l option lets you use .Nm where a screen-oriented interface would not be useful, for example, from another screen-oriented program. .Pp .Nm will prompt with >> when it is ready for an input line starting with the field number (counting from 0) immediately followed by the search pattern, for example, ``lmain'' finds the definition of the main function. .Pp If you just want a single search, instead of the .Fl l option use the .Fl L and .Fl num pattern options, and you won't get the >> prompt. .Pp For .Fl l , .Nm outputs the number of reference lines .Bd -literal -offset indent .Nm Ns : 2 lines .Ed .Pp For each reference found, .Nm outputs a line consisting of the file name, function name, line number, and line text, separated by spaces, for example, .Bd -literal -offset indent main.c main 161 main(argc, argv) .Ed .Pp Note that the editor is not called to display a single reference, unlike the screen-oriented interface. .Pp You can use the c command to toggle ignore/use letter case when searching. (When ignoring letter case, search for ``FILE'' will match ``File'' and ``file''.) .Pp You can use the r command to rebuild the database. .Pp .Nm will quit when it detects end-of-file, or when the first character of an input line is ``^d'' or ``q''. .Pp .Ss Environment variables .Bl -tag -width INCLUDEDIRSx -indent .It Ev EDITOR Preferred editor, which defaults to vi. .It Ev HOME Home directory, which is automatically set at login. .It Ev INCLUDEDIRS Colon-separated list of directories to search for #include files. .It Ev SHELL Preferred shell, which defaults to sh. .It Ev SOURCEDIRS Colon-separated list of directories to search for additional source files. .It Ev TERM Terminal type, which must be a screen terminal. .It Ev TERMINFO Terminal information directory full path name. If your terminal is not in the standard terminfo directory, see curses and terminfo for how to make your own terminal description. .It Ev TMPDIR Temporary file directory, which defaults to /var/tmp. .It Ev VIEWER Preferred file display program (such as less), which overrides .Ev EDITOR (see above). .It Ev VPATH A colon-separated list of directories, each of which has the same directory structure below it. If VPATH is set, .Nm searches for source files in the directories specified; if it is not set, .Nm searches only in the current directory. .El .Pp .Ss Files .Bl -tag -width indent .It Em cscope.files Default files containing .Fl I , .Fl p , .Fl q , and .Fl T options and the list of source files (overridden by the .Fl i option). .It Em cscope.out Symbol cross-reference file (overridden by the .Fl f option), which is put in the home directory if it cannot be created in the current directory. .It Em cscope.in.out, cscope.po.out Default files containing the inverted index used for quick symbol searching .Ns ( Fl q option). If you use the .Fl f option to rename the cross-reference file (so it's not cscope.out ), the names for these inverted index files will be created by adding .in and .po to the name you supply with .Fl f . For example, if you indicated .Fl f Ar xyz , then these files would be named xyz.in and xyz.po. .It Em INCDIR Standard directory for #include files (usually .Pa /usr/include ) . .El .Pp .Ss Notices .Pp .Nm recognizes function definitions of the form: .Pp fname blank ( args ) white arg_decs white { .Bl -tag -width indent .It Sy where: .It fname is the function name .It blank is zero or more spaces or tabs, not including newlines .It args is any string that does not contain a ``"'' or a newline .It white is zero or more spaces, tabs, or newlines .It arg_decs are zero or more argument declarations (arg_decs may include comments and white space) .El .Pp It is not necessary for a function declaration to start at the beginning of a line. The return type may precede the function name; .Nm will still recognize the declaration. Function definitions that deviate from this form will not be recognized by .Nm .Pp The ``Function'' column of the search output for the menu option Find functions called by this function: input field will only display the first function called in the line, that is, for this function .Bd -literal -offset indent e() { return (f() + g()); } .Ed .Pp the display would be: .Bd -literal -offset indent Functions called by this function: e File Function Line a.c f 3 return(f() + g()); .Ed .Pp Occasionally, a function definition or call may not be recognized because of braces inside #if statements. Similarly, the use of a variable may be incorrectly recognized as a definition. .Pp A typedef name preceding a preprocessor statement will be incorrectly recognized as a global definition, for example, .Bd -literal -offset indent LDFILE * #if AR16WR .Ed .Pp Preprocessor statements can also prevent the recognition of a global definition, for example, .Bd -literal -offset indent char flag #ifdef ALLOCATE_STORAGE = -1 #endif ; .Ed .Pp A function declaration inside a function is incorrectly recognized as a function call, for example, .Bd -literal -offset indent f() { void g(); } .Ed .Pp is incorrectly recognized as a call to g. .Pp .Nm recognizes C++ classes by looking for the class keyword, but doesn't recognize that a struct is also a class, so it doesn't recognize inline member function definitions in a structure. It also doesn't expect the class keyword in a typedef, so it incorrectly recognizes X as a definition in .Bd -literal -offset indent typedef class X * Y; .Ed .Pp It also doesn't recognize operator function definitions .Bd -literal -offset indent Bool Feature::operator==(const Feature & other) { \&... } .Ed .Pp Nor does it recognize function definitions with a function pointer argument. .Bd -literal -offset indent ParseTable::Recognize(int startState, char *pattern, int finishState, void (*FinalAction)(char *)) { \&... } .Ed .Sh COPYRIGHT 17 April 2000 The Santa Cruz Operation, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Tue Apr 25 22:10:19 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 46A5D37B8D3; Tue, 25 Apr 2000 22:10:18 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Received: (from jkoshy@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA03515; Tue, 25 Apr 2000 22:10:18 -0700 (PDT) (envelope-from jkoshy@FreeBSD.org) Date: Tue, 25 Apr 2000 22:10:18 -0700 (PDT) From: Message-Id: <200004260510.WAA03515@freefall.freebsd.org> To: ben@scientia.demon.co.uk, jkoshy@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/18214: minor errors in sched_get_priority_max(2) manual page Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Synopsis: minor errors in sched_get_priority_max(2) manual page State-Changed-From-To: open->closed State-Changed-By: jkoshy State-Changed-When: Tue Apr 25 22:09:47 PDT 2000 State-Changed-Why: Fixed in rev 1.5 of "src/lib/libc/sys/sched_get_priority_max.2", thanks! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Apr 26 8:20: 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 3B31037BEA1 for ; Wed, 26 Apr 2000 08:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA42144; Wed, 26 Apr 2000 08:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from smtp10.atl.mindspring.net (smtp10.atl.mindspring.net [207.69.200.246]) by hub.freebsd.org (Postfix) with ESMTP id 8018F37BDC8 for ; Wed, 26 Apr 2000 08:18:45 -0700 (PDT) (envelope-from tomdean@ix.netcom.com) Received: from ix.netcom.com (sil-wa15-33.ix.netcom.com [207.93.148.33]) by smtp10.atl.mindspring.net (8.9.3/8.8.5) with ESMTP id LAA09224 for ; Wed, 26 Apr 2000 11:18:42 -0400 (EDT) Received: (from tomdean@localhost) by ix.netcom.com (8.9.3/8.9.3) id IAA10736; Wed, 26 Apr 2000 08:18:33 -0700 (PDT) (envelope-from tomdean) Message-Id: <200004261518.IAA10736@ix.netcom.com> Date: Wed, 26 Apr 2000 08:18:33 -0700 (PDT) From: "Thomas D. Dean" Reply-To: tomdean@ix.netcom.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18233: man and nroff -mdoc produce extra blank lines. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18233 >Category: docs >Synopsis: man and nroff -mdoc produce extra blank lines. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Wed Apr 26 08:20:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Thomas D. Dean >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: >Description: 'man make' has extra (doubled) blank lines in it. Several other man pages have extra blank lines in them. The template man page with only .Sh and .Pp plus pain text [A-Za-z]* in it will contain extra blank lines. 'nroff -man' and 'nroff -mdoc' both exhibit the problem. >How-To-Repeat: The following script will produce a nroff source file that will duplicate the problem. 'xx.sh > xx.1' followed by 'nroff -mdoc xx.1' The output will have an extra blank line at line number 66. Pipe the output of nroff into 'grep -n ".*"' to see line numbers. If the number of sections is increased from 10 to 30, lines 66, 132, 198, etc will be extra blank lines. If xx.1 is placed in the MANPATH, 'man xx' will produce the problem. #! /bin/sh # generate a man page which will have an extra blank line cat <Fix: >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Apr 26 10:20: 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 B553137BE95 for ; Wed, 26 Apr 2000 10:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id KAA55939; Wed, 26 Apr 2000 10:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Wed, 26 Apr 2000 10:20:02 -0700 (PDT) Message-Id: <200004261720.KAA55939@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Mike Pritchard Subject: Re: docs/18233: man and nroff -mdoc produce extra blank lines. Reply-To: Mike Pritchard Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/18233; it has been noted by GNATS. From: Mike Pritchard To: "Thomas D. Dean" Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/18233: man and nroff -mdoc produce extra blank lines. Date: Wed, 26 Apr 2000 12:17:48 -0500 On Wed, Apr 26, 2000 at 08:18:33AM -0700, Thomas D. Dean wrote: > >Synopsis: man and nroff -mdoc produce extra blank lines. > >Description: > 'man make' has extra (doubled) blank lines in it. Several other > man pages have extra blank lines in them. The template man page > with only .Sh and .Pp plus pain text [A-Za-z]* in it will contain > extra blank lines. 'nroff -man' and 'nroff -mdoc' both exhibit > the problem. > > >How-To-Repeat: > > The following script will produce a nroff source file that will > duplicate the problem. 'xx.sh > xx.1' followed by 'nroff -mdoc xx.1' > The output will have an extra blank line at line number 66. Pipe > the output of nroff into 'grep -n ".*"' to see line numbers. > If the number of sections is increased from 10 to 30, lines > 66, 132, 198, etc will be extra blank lines. If xx.1 is placed in > the MANPATH, 'man xx' will produce the problem. The extra blank lines are at page breaks within the man page. 66 lines of text is one printed page of output. 132 lines of text is two pages of text, etc. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Wed Apr 26 15: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 E68F537BA73 for ; Wed, 26 Apr 2000 15:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id PAA94918; Wed, 26 Apr 2000 15:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from happy.checkpoint.com (happy.checkpoint.com [199.203.156.41]) by hub.freebsd.org (Postfix) with ESMTP id 1DF1837BA73 for ; Wed, 26 Apr 2000 15:40:50 -0700 (PDT) (envelope-from mellon@happy.checkpoint.com) Received: (from mellon@localhost) by happy.checkpoint.com (8.9.3/8.9.3) id BAA95539; Thu, 27 Apr 2000 01:40:57 GMT (envelope-from mellon) Message-Id: <200004270140.BAA95539@happy.checkpoint.com> Date: Thu, 27 Apr 2000 01:40:57 GMT From: mellon@pobox.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18243: a mistake in sh.1 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18243 >Category: docs >Synopsis: wrong description of -p option in sh(1) manpage >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: Wed Apr 26 15:50:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Anatoly Vorobey >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: -CURRENT >Description: A simple mistake in the manpage of sh(1). The patch below is self-explanatory. The relevant code handling the option is in bin/sh/options.s >How-To-Repeat: >Fix: --- sh.1.old Thu Apr 27 01:33:32 2000 +++ sh.1 Thu Apr 27 01:37:44 2000 @@ -229,7 +229,7 @@ .It Fl p Li privileged Turn on privileged mode. This mode is enabled on startup if either the effective user or group id is not equal to the -real user or group id. Turning this mode off sets the +real user or group id. Turning this mode on sets the effective user and group ids to the real user and group ids. When this mode is enabled for interactive shells, the file .Pa /etc/suid_profile >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 Apr 26 23:24:52 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sttlpop2.sttl.uswest.net (sttlpop2.sttl.uswest.net [206.81.192.2]) by hub.freebsd.org (Postfix) with SMTP id AD15437B632 for ; Wed, 26 Apr 2000 23:24:50 -0700 (PDT) (envelope-from garth@cs.colorado.edu) Received: (qmail 22618 invoked by alias); 27 Apr 2000 06:24:50 -0000 Delivered-To: fixup-freebsd-doc@FreeBSD.ORG@fixme Received: (qmail 22601 invoked by uid 0); 27 Apr 2000 06:24:49 -0000 Received: from gdslppp250.sttl.uswest.net (HELO pelagius) (216.160.93.250) by sttlpop2.sttl.uswest.net with SMTP; 27 Apr 2000 06:24:49 -0000 From: "Garth Snyder" To: Subject: Is FreeBSD a registered trademark? Date: Wed, 26 Apr 2000 23:25:04 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.6700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi - What's the proper way to refer to FreeBSD in written materials? FreeBSD^TM? FreeBSD^(R)? Just FreeBSD? Thanks, Garth To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 1: 0:13 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 35E7137B59E for ; Thu, 27 Apr 2000 01:00:11 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id BAA51004; Thu, 27 Apr 2000 01:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Thu, 27 Apr 2000 01:00:02 -0700 (PDT) Message-Id: <200004270800.BAA51004@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Sheldon Hearn Subject: Re: docs/18243: a mistake in sh.1 Reply-To: Sheldon Hearn Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/18243; it has been noted by GNATS. From: Sheldon Hearn To: mellon@pobox.com Cc: FreeBSD-gnats-submit@FreeBSD.ORG, martin@FreeBSD.org Subject: Re: docs/18243: a mistake in sh.1 Date: Thu, 27 Apr 2000 09:54:07 +0200 On Thu, 27 Apr 2000 01:40:57 GMT, mellon@pobox.com wrote: > .It Fl p Li privileged > Turn on privileged mode. This mode is enabled on startup > if either the effective user or group id is not equal to the > -real user or group id. Turning this mode off sets the > +real user or group id. Turning this mode on sets the > effective user and group ids to the real user and group ids. Weird, I don't get this at all. My take on the code is that it should say something like: Set the effective user and group ids to the real user and group ids respectively if this option is enabled on startup. The existing text doesn't make any sense to me. Am I right with my description? Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 1:20:43 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 2676937B515 for ; Thu, 27 Apr 2000 01:20:38 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id BAA53534; Thu, 27 Apr 2000 01:20:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Thu, 27 Apr 2000 01:20:04 -0700 (PDT) Message-Id: <200004270820.BAA53534@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Anatoly Vorobey Subject: Re: docs/18243: a mistake in sh.1 Reply-To: Anatoly Vorobey Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/18243; it has been noted by GNATS. From: Anatoly Vorobey To: Sheldon Hearn Cc: FreeBSD-gnats-submit@FreeBSD.ORG, martin@FreeBSD.ORG Subject: Re: docs/18243: a mistake in sh.1 Date: Thu, 27 Apr 2000 04:12:46 -0400 You, Sheldon Hearn, were spotted writing this on Thu, Apr 27, 2000 at 09:54:07AM +0200: > > On Thu, 27 Apr 2000 01:40:57 GMT, mellon@pobox.com wrote: > > > .It Fl p Li privileged > > Turn on privileged mode. This mode is enabled on startup > > if either the effective user or group id is not equal to the > > -real user or group id. Turning this mode off sets the > > +real user or group id. Turning this mode on sets the > > effective user and group ids to the real user and group ids. > > Weird, I don't get this at all. My take on the code is that it should > say something like: > > Set the effective user and group ids > to the real user and group ids respectively > if this option is enabled on startup. > > The existing text doesn't make any sense to me. Am I right with my > description? Yes. The option exists to guard against suid shell scripts (I presume) by denying the shell any privileges it has from the suid bit. The existing text, however, intends to describe both the effect of the option and the general effect of the shell running suid. It calls the former "turning the option on" and the latter "enabling the option" referring to *different* things by these which is damn confusing. If the shell is running suid, a different profile file is sourced and $ENV is ignored -- both regardless of the -p option -- and the text tries to explain this. I think the description of different behavior under suid should be put elsewhere earlier in the manpage, and referred to as running in the privileged mode, while -p should be described as you did together with stating that it only works in privileged mode. There's no point in describing -p as "turning the privileged mode on" anyway because it would be typically used to take extra privileges away rather than enable them. If you can hack this, more power to you! I tried to rewrite this paragraph coherently, but gave up soon; thus the fix in my PR only fixed the most obvious error, while secretly hoping people'll notice the general stylistic conundrum. It worked ;) -- Anatoly Vorobey, mellon@pobox.com http://pobox.com/~mellon/ "Angels can fly because they take themselves lightly" - G.K.Chesterton To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 2:59:12 2000 Delivered-To: freebsd-doc@freebsd.org Received: from columbus.cris.net (columbus.cris.net [212.110.128.65]) by hub.freebsd.org (Postfix) with ESMTP id 70D3837B576 for ; Thu, 27 Apr 2000 02:58:59 -0700 (PDT) (envelope-from phantom@FreeBSD.org.ua) Received: from phantom.cris.net (phantom.cris.net [212.110.130.74]) by columbus.cris.net (8.9.3/8.9.3) with ESMTP id MAA03018; Thu, 27 Apr 2000 12:56:06 +0300 (EEST) Received: (from phantom@localhost) by phantom.cris.net (8.9.3/8.9.3) id MAA51211; Thu, 27 Apr 2000 12:58:17 +0300 (EEST) (envelope-from phantom) Date: Thu, 27 Apr 2000 12:58:17 +0300 From: Alexey Zelkin To: John Estess Cc: Mike Pritchard , doc@FreeBSD.ORG, sheldonh@uunet.co.za, petr@users.sourceforge.net, obrien@NUXI.com Subject: Re: last time for mdoc corrections Message-ID: <20000427125817.A51057@phantom.cris.net> References: <20000425084542.A50322@mppsystems.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: ; from jestess@wcnet.net on Tue, Apr 25, 2000 at 04:20:53PM -0500 X-Operating-System: FreeBSD 4.0-STABLE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Tue, Apr 25, 2000 at 04:20:53PM -0500, John Estess wrote: > .Os FreeBSD 4.0 Is it FreeBSD only tool ? If it isn't just leave .Os macro with no arguments. > for any #include files whose names do not begin with ``/'' and that are not General comment to that and all next cases: please replace all occurences of double quotations (``xxx'') with ".Dq xxx" > .It Ev VPATH > A colon-separated list of directories, each of which has the > same directory structure below it. If VPATH is set, ^^ == .Ev VPATH > then these files would be named > xyz.in and xyz.po. .Pa xyz.in and .Pa xyz.po. > .Sh COPYRIGHT > 17 April 2000 The Santa Cruz Operation, Inc. By style guide this section will have AUTHORS name. -- /* Alexey Zelkin && phantom@cris.net */ /* Tavric National University && phantom@crimea.edu */ /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 6:12: 9 2000 Delivered-To: freebsd-doc@freebsd.org Received: from wcn4.wcnet.net (mail.wcnet.net [216.88.248.234]) by hub.freebsd.org (Postfix) with ESMTP id ABFD437B85A for ; Thu, 27 Apr 2000 06:11:55 -0700 (PDT) (envelope-from jestess@wcnet.net) Received: from elcampo-0276.wcnet.net [216.88.249.105] by wcn4.wcnet.net with ESMTP (SMTPD32-6.00) id AC922F1A0082; Thu, 27 Apr 2000 08:11:46 -0500 Date: Thu, 27 Apr 2000 08:15:55 -0500 (CDT) From: John Estess X-Sender: jestess@localhost.localdomain To: Alexey Zelkin Cc: Mike Pritchard , sheldonh@uunet.co.za, petr@users.sourceforge.net, obrien@NUXI.com, doc@freebsd.org Subject: Re: last time for mdoc corrections In-Reply-To: <20000427154714.A51592@phantom.cris.net> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Triple liar... > .Ao Ctrl Ac Ns -e angle brackets stripped except as arg for -width .Dd April 26, 2000 .Dt CSCOPE 1 .Os .Sh NAME .Nm cscope .Nd interactively examine a C program .Sh SYNOPSIS .Nm cscope .Op options .Op file... .Sh DESCRIPTION .Nm is an interactive, screen-oriented tool that allows the user to browse through C source files for specified elements of code. .Pp By default, .Nm examines the C .Pq "\&.c and \&.h" , lex .Pq \&.l , and yacc .Pq \&.y source files in the current directory. .Nm may also be invoked for source files named on the command line. In either case, .Nm searches the standard directories for #include files that it does not find in the current directory. .Nm uses a symbol cross-reference, .Pa cscope.out by default, to locate functions, function calls, macros, variables, and preprocessor symbols in the files. .Pp .Nm builds the symbol cross-reference the first time it is used on the source files for the program being browsed. On a subsequent invocation, .Nm rebuilds the cross-reference only if a source file has changed or the list of source files is different. When the cross-reference is rebuilt, the data for the unchanged files are copied from the old cross-reference, which makes rebuilding faster than the initial build. .Pp The following options can appear in any combination: .Bl -tag -width indent .It Fl b Build the cross-reference only. .It Fl C Ignore letter case when searching. .It Fl c Use only ASCII characters in the cross-reference file, that is, do not compress the data. .It Fl d Do not update the cross-reference. .It Fl e Suppress the .Ao Ctrl Ac Ns -e command prompt between files. .It Fl F Ar symfile Read symbol reference lines from .Ar symfile . (A symbol reference file is created by > and >>, and can also be read using the < command, described under .Dq Issuing Subsequent Requests, below.) .It Fl f Ar reffile Use .Ar reffile as the cross-reference file name instead of the default .Pa cscope.out . .It Fl I Ar incdir Look in .Ar incdir (before looking in INCDIR, the standard place for header files, normally .Pa /usr/include ) for any #include files whose names do not begin with .Dq / and that are not specified on the command line or in namefile below. (The #include files may be specified with either double quotes or angle brackets.) The incdir directory is searched in addition to the current directory (which is searched first) and the standard list (which is searched last). If more than one occurrence of .Fl I appears, the directories are searched in the order they appear on the command line. .It Fl i Ar namefile Browse through all source files whose names are listed in namefile .Pq file names separated by spaces, tabs, or new-lines instead of the default .Pq Pa cscope.files . If this option is specified, .Nm ignores any files appearing on the command line. .It Fl L Do a single search with line-oriented output when used with the .Fl num pattern option. .It Fl l Line-oriented interface (see .Dq Line-Oriented Interface below). .It Fl num Ar pattern Go to input field num (counting from 0) and find pattern. .It Fl P Ar path Prepend path to relative file names in a pre-built cross-reference file so you do not have to change to the directory where the cross-reference file was built. This option is only valid with the .Fl d option. .It Fl p Ar n Display the last .Sy n file path components instead of the default (1). Use 0 to not display the file name at all. .It Fl q Build an inverted index for quick symbol searching. If you use this option with the .Fl f option, you must use .Fl f on every call to .Nm Ns , including when you build the cross-reference file, because it changes the names of the inverted index files. .It Fl s Ar dir Look in .Pa dir for additional source files. This option is ignored if source files are given on the command line. .It Fl T Use only the first eight characters to match against C symbols. A regular expression containing special characters other than a period (.) will not match any symbol if its minimum length is greater than eight characters. .It Fl U Check file time stamps. This option will update the time stamp on the database even if no files have changed. .It Fl u Unconditionally build the cross-reference file (assume that all files have changed). .It Fl V Print on the first line of screen the version number of .Nm Ns . .Pp The .Fl I , .Fl p , .Fl q , and .Fl T options can also be in the .Pa cscope.files file. .El .Pp .Ss Requesting the initial search .Pp After the cross-reference is ready, .Nm will display this menu: .Pp .Bd -literal -offset indent Find this C symbol: Find this function definition: Find functions called by this function: Find functions calling this function: Find this text string: Change this text string: Find this egrep pattern: Find this file: Find files #including this file: .Ed .Pp Press the .Aq Tab key repeatedly to move to the desired input field, type the text to search for, and then press the .Aq Return key. .Pp .Ss Issuing subsequent requests .Pp If the search is successful, any of these single-character commands can be used: .Bl -tag -width -offset indent .It Sy 1-9 Edit the file referenced by the given line number. .It Aq Sy Space Display next set of matching lines. .It Sy + Display next set of matching lines. .It Sy - Display previous set of matching lines. .It Sy ^e Edit displayed files in order. .It Sy > Write the displayed list of lines to a file. .It Sy >> Append the displayed list of lines to a file. .It Sy < Read lines from a file that is in symbol reference format (created by > or >>), just like the -F option. .It Sy ^ Filter all lines through a shell command and display the resulting lines, replacing the lines that were already there. .It Sy | Pipe all lines to a shell command and display them without changing them. .El .Pp At any time these single-character commands can also be used: .Bl -tag -width -offset indent .It Aq Sy Tab Move to next input field. .It Aq Sy Return Move to next input field. .It Sy ^n Move to next input field. .It Sy ^p Move to previous input field. .It Sy ^y Search with the last text typed. .It Sy ^b Move to previous input field and search pattern. .It Sy ^f Move to next input field and search pattern. .It Sy ^c Toggle ignore/use letter case when searching. (When ignoring letter case, search for .Dq FILE will match .Dq File and .Dq file . ) .It Sy ^r Rebuild the cross-reference. .It Sy ! Start an interactive shell (type ^d to return to .Nm Ns ) . .It Sy ^l Redraw the screen. .It Sy ? Give help information about .Nm commands. .It Sy ^d Exit .Nm .El .Pp NOTE: If the first character of the text to be searched for matches one of the above commands, escape it by typing a \e (backslash) first. .Pp .Ss Substituting new text for old text .Pp After the text to be changed has been typed, .Nm will prompt for the new text, and then it will display the lines containing the old text. Select the lines to be changed with these single-character commands: .Bl -tag -width x -indent .It 1-9 Mark or unmark the line to be changed. .It * Mark or unmark all displayed lines to be changed. .It Aq Space Display next set of lines. .It + Display next set of lines. .It - Display previous set of lines. .It a Mark or unmark all lines to be changed. .It \^d Change the marked lines and exit. .It Aq Esc Exit without changing the marked lines. .It ! Start an interactive shell (type ^d to return to .Nm Ns ) . .It ^l Redraw the screen. .It ? Give help information about .Nm commands. .El .Pp .Ss Special keys .Pp If your terminal has arrow keys that work in vi, you can use them to move around the input fields. The up-arrow key is useful to move to the previous input field instead of using the .Aq Tab key repeatedly. If you have .Aq CLEAR , .Aq NEXT , or .Aq PREV keys they will act as the ^l, +, and - commands, respectively. .Pp .Ss Line-Oriented interface .Pp The .Fl l option lets you use .Nm where a screen-oriented interface would not be useful, for example, from another screen-oriented program. .Pp .Nm will prompt with >> when it is ready for an input line starting with the field number (counting from 0) immediately followed by the search pattern, for example, .Dq lmain finds the definition of the main function. .Pp If you just want a single search, instead of the .Fl l option use the .Fl L and .Fl num pattern options, and you won't get the >> prompt. .Pp For .Fl l , .Nm outputs the number of reference lines .Bd -literal -offset indent .Nm Ns : 2 lines .Ed .Pp For each reference found, .Nm outputs a line consisting of the file name, function name, line number, and line text, separated by spaces, for example, .Bd -literal -offset indent main.c main 161 main(argc, argv) .Ed .Pp Note that the editor is not called to display a single reference, unlike the screen-oriented interface. .Pp You can use the c command to toggle ignore/use letter case when searching. (When ignoring letter case, search for .Dq FILE will match .Dq File and .Dq file . ) .Pp You can use the r command to rebuild the database. .Pp .Nm will quit when it detects end-of-file, or when the first character of an input line is .Dq ^d or .Dq q . .Pp .Sh ENVIRONMENT .Bl -tag -width INCLUDEDIRSx -indent .It Ev EDITOR Preferred editor, which defaults to vi. .It Ev HOME Home directory, which is automatically set at login. .It Ev INCLUDEDIRS Colon-separated list of directories to search for #include files. .It Ev SHELL Preferred shell, which defaults to sh. .It Ev SOURCEDIRS Colon-separated list of directories to search for additional source files. .It Ev TERM Terminal type, which must be a screen terminal. .It Ev TERMINFO Terminal information directory full path name. If your terminal is not in the standard terminfo directory, see curses and terminfo for how to make your own terminal description. .It Ev TMPDIR Temporary file directory, which defaults to /var/tmp. .It Ev VIEWER Preferred file display program (such as less), which overrides .Ev EDITOR (see above). .It Ev VPATH A colon-separated list of directories, each of which has the same directory structure below it. If .Ev VPATH is set, .Nm searches for source files in the directories specified; if it is not set, .Nm searches only in the current directory. .El .Pp .Sh FILES .Bl -tag -width indent .It Em cscope.files Default files containing .Fl I , .Fl p , .Fl q , and .Fl T options and the list of source files (overridden by the .Fl i option). .It Em cscope.out Symbol cross-reference file (overridden by the .Fl f option), which is put in the home directory if it cannot be created in the current directory. .It Em cscope.in.out Ns , Em cscope.po.out Default files containing the inverted index used for quick symbol searching .Ns ( Fl q option). If you use the .Fl f option to rename the cross-reference file (so it's not .Pa cscope.out ), the names for these inverted index files will be created by adding .in and .po to the name you supply with .Fl f . For example, if you indicated .Fl f Ar xyz , then these files would be named .Pa xyz.in and .Pa xyz.po . .It Em INCDIR Standard directory for #include files (usually .Pa /usr/include ) . .El .Pp .Ss Notices .Pp .Nm recognizes function definitions of the form: .Bd -literal -offset indent fname blank ( args ) white arg_decs white { .Ed .Bl -tag -width indent .It Sy where: .It fname is the function name .It blank is zero or more spaces or tabs, not including newlines .It args is any string that does not contain a .Dq \&" or a newline .It white is zero or more spaces, tabs, or newlines .It arg_decs are zero or more argument declarations (arg_decs may include comments and white space) .El .Pp It is not necessary for a function declaration to start at the beginning of a line. The return type may precede the function name; .Nm will still recognize the declaration. Function definitions that deviate from this form will not be recognized by .Nm Ns . .Pp The .Dq Function column of the search output for the menu option Find functions called by this function: input field will only display the first function called in the line, that is, for this function .Bd -literal -offset indent e() { return (f() + g()); } .Ed .Pp the display would be: .Bd -literal -offset indent Functions called by this function: e File Function Line a.c f 3 return(f() + g()); .Ed .Pp Occasionally, a function definition or call may not be recognized because of braces inside #if statements. Similarly, the use of a variable may be incorrectly recognized as a definition. .Pp A typedef name preceding a preprocessor statement will be incorrectly recognized as a global definition, for example, .Bd -literal -offset indent LDFILE * #if AR16WR .Ed .Pp Preprocessor statements can also prevent the recognition of a global definition, for example, .Bd -literal -offset indent char flag #ifdef ALLOCATE_STORAGE = -1 #endif ; .Ed .Pp A function declaration inside a function is incorrectly recognized as a function call, for example, .Bd -literal -offset indent f() { void g(); } .Ed .Pp is incorrectly recognized as a call to g. .Pp .Nm recognizes C++ classes by looking for the class keyword, but doesn't recognize that a struct is also a class, so it doesn't recognize inline member function definitions in a structure. It also doesn't expect the class keyword in a typedef, so it incorrectly recognizes X as a definition in .Bd -literal -offset indent typedef class X * Y; .Ed .Pp It also doesn't recognize operator function definitions .Bd -literal -offset indent Bool Feature::operator==(const Feature & other) { \&... } .Ed .Pp Nor does it recognize function definitions with a function pointer argument. .Bd -literal -offset indent ParseTable::Recognize(int startState, char *pattern, int finishState, void (*FinalAction)(char *)) { \&... } .Ed .Sh COPYRIGHT 17 April 2000 The Santa Cruz Operation, Inc. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 7:34: 3 2000 Delivered-To: freebsd-doc@freebsd.org Received: from pascal.uol.com.br (pascal.uol.com.br [200.230.198.87]) by hub.freebsd.org (Postfix) with ESMTP id D644437B7D1 for ; Thu, 27 Apr 2000 07:33:49 -0700 (PDT) (envelope-from fmor@uol.com.br) Received: from f (200-191-70-32-as.acessonet.com.br [200.191.70.32]) by pascal.uol.com.br (8.9.1/8.9.1) with SMTP id LAA00779 for ; Thu, 27 Apr 2000 11:33:12 -0300 (BRT) Message-ID: <00e701bfb055$f5d8d440$2046bfc8@f.mor> From: "fmor" To: Subject: =?iso-8859-1?Q?Meus_servi=E7os?= Date: Thu, 27 Apr 2000 11:36:20 -0300 MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_NextPart_000_00E4_01BFB03C.CEE7FE60" X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 4.72.3110.5 X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3110.3 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org This is a multi-part message in MIME format. ------=_NextPart_000_00E4_01BFB03C.CEE7FE60 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Prezados Srs, Por meio deste estou lhes enviando um resumo de minhas atividades = profissionais para sua devida considera=E7=E3o. CURRICULUM VITAE =20 Nome: Maur=EDcio Mor. Rg. : 10.322.253; C.I.C: 874.685.908-00; CCM: 2.781.079-8. Endere=E7o: Rua Albuquerque Lins, 107 Apto. 124 =96 a, Santa Cec=EDlia, = S=E3o Paulo =96 SP. CEP: 01230-000. Telefax: (0xx11) 825-4743; Celular: (0xx11) 9303-4481. E-mail: fmor@uol.com.br. Estado civil: casado. Nacionalidade: brasileiro. Data de nascimento: 26/11/1949. =20 Ocupa=E7=E3o atual. Atividade de Free-Lancer em tradu=E7=F5es t=E9cnicas e gerais, junto a = CIT =96 Centro Internacional de Tradu=E7=F5es e Servi=E7os S/C Ltda e a = Andrart Tradu=E7=F5es S/C. Ocupa=E7=F5es anteriores. Empresa: Brasilfax- SP Com. Exp. Imp. Ltda. Cargo: Assistente de Importa=E7=E3o/Exporta=E7=E3o e tradutor interno, = incluindo viagens de representa=E7=E3o da firma aos Estados Unidos para = a exposi=E7=E3o mundial de reciclagem de toner e cartuchos jato de tinta = em Las Vegas EUA. Per=EDodo: 01/1998 at=E9 02/1999. =20 Empresa: All Tasks=E2 Tradu=E7=F5es T=E9cnicas, Editora=E7=E3o = Eletr=F4nica e Software Localization. Per=EDodo: 01/1996 at=E9 01/1998. Cargo: Revisor/Tradutor t=E9cnico com =EAnfase nas =E1reas de = telecomunica=E7=F5es, inform=E1tica, mec=E2nica, patentes, e = administra=E7=E3o de modo geral. =20 Empresa: Arte-sul ind. e com. Ltda. Per=EDodo: 1987 at=E9 1995. Cargo: S=F3cio-Gerente Administrativo/Produ=E7=E3o. =20 Empresa: Hotel Pamplona Palace Ltda. Per=EDodo: 1984 at=E9 1986. Cargo: Gerente de hospedagem. =20 Empresa: Mod. Servi=E7os S/C Ltda. (MK. Analise de sistemas s/a Ltda.). Per=EDodo: 1983 at=E9 1984. Cargo: Programador de computador (Cobol). =20 Empresa: Confec=E7=F5es Ilanit ltda.=20 Per=EDodo: 1978 at=E9 1983. Cargo: Gerente. =20 Empresa: Arno S/A. Ind. e Com de Eletrodom=E9sticos. Per=EDodo: 1977 at=E9 1978. Cargo: Cronot=E9cnico. =20 Empresa: Noruega Ind. e Com. de Malhas ltda. Per=EDodo: 1976 at=E9 1977. Cargo: Chefe de tempos e m=E9todos. =20 Informa=E7=E3o profissional. Micro Pentium - ll 300 com 64 Mb de RAM, impressora Cannon BJC - 4000 = jato de tinta, placa de Fax-Modem U.S Robotics 28.800, Windows 95 e = Office 97. Conhecimentos de Trados. =20 Escolaridade. Instituto Nacional de Produ=E7=E3o e Produtividade Faculdade de Tecnologia e Engenharia de Produ=E7=E3o=20 Forma=E7=E3o em 1972 em Tecnologia de Produ=E7=E3o Local: Tel-Aviv.(Israel). =20 Medidas de Tempos & M=E9todos (M.T.M - I) Escola: The British Methods-Time Measurement Association Limited Dura=E7=E3o do curso: 12 meses=20 Certificado de Analista de Medidas de Tempos dos M=E9todos Local: Londres, em 1974. =20 Franc=EAs contempor=E2neo Escola: Alian=E7a Francesa de Paris (Fran=E7a) Certificado de franc=EAs 4=BA grau da Alian=E7a Francesa e Certificait = de Fran=E7ais Pratique da Sorbonne em 1975 Local: Paris (Fran=E7a). =20 Medidas de Tempos & M=E9todos (M.T.M - II) Escola: SENAI Dura=E7=E3o do curso: quatro meses Certificado de Analista de Tempos & M=E9todos - II Local: S=E3o Paulo, em 1978. =20 Programa=E7=E3o Cobol Escola: Servimec Dura=E7=E3o do curso: oito meses Local: S=E3o Paulo, em 1982. =20 Organiza=E7=E3o & M=E9todos Escola: Datamec Dura=E7=E3o do curso: quatro meses, local: S=E3o Paulo, em 1985. =20 Curso de Dos, Windows, Word e Excel Escola: Data Sell Dura=E7=E3o: 60 horas em 1997 Local: S=E3o Paulo. =20 Curso de Reda=E7=E3o e Atualiza=E7=E3o Gramatical Escola: Verbum Dura=E7=E3o: 2 meses em 09/10 de 1999 Local: s=E3o Paulo. =20 Oficina de Tradu=E7=E3o e Vers=E3o Escola: Pontifica Universidade Cat=F3lica de S=E3o Paulo Dura=E7=E3o: 2 meses, em andamento. Local: S=E3o Paulo. =20 Idiomas. Ingl=EAs, Franc=EAs, Hebraico ------=_NextPart_000_00E4_01BFB03C.CEE7FE60 Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable

Prezados Srs,

Por meio deste estou lhes enviando um = resumo de=20 minhas atividades profissionais para sua devida=20 consideração.

CURRICULUM=20 VITAE

Nome: Maurício = Mor.

Rg. : 10.322.253; = C.I.C:=20 874.685.908-00; CCM: 2.781.079-8.

Endereço: Rua = Albuquerque=20 Lins, 107 Apto. 124 – a, Santa Cecília, São Paulo = –=20 SP.

CEP: 01230-000.

Telefax: (0xx11) = 825-4743;=20 Celular: (0xx11) 9303-4481.

E-mail: = fmor@uol.com.br.

Estado civil: = casado.

Nacionalidade: = brasileiro.

Data de nascimento:=20 26/11/1949.

Ocupação=20 atual.

Atividade de = Free-Lancer=20 em traduções técnicas e gerais, junto a CIT = –=20 Centro Internacional de Traduções e Serviços S/C = Ltda e a=20 Andrart Traduções S/C.

Ocupações=20 anteriores.

Empresa: Brasilfax- = SP Com. Exp.=20 Imp. Ltda.

Cargo: Assistente de=20 Importação/Exportação e tradutor interno, = incluindo=20 viagens de representação da firma aos Estados Unidos para = a=20 exposição mundial de reciclagem de toner e cartuchos jato = de tinta=20 em Las Vegas EUA.

Período: = 01/1998=20 até 02/1999.

Empresa: All = Tasksâ=20 Traduções Técnicas, Editoração=20 Eletrônica e Software Localization.

Período: = 01/1996=20 até 01/1998.

Cargo: = Revisor/Tradutor=20 técnico com ênfase nas áreas de=20 telecomunicações, informática, mecânica, = patentes,=20 e administração de modo geral.

Empresa: Arte-sul = ind. e com.=20 Ltda.

Período: 1987 = até=20 1995.

Cargo: = Sócio-Gerente=20 Administrativo/Produção.

Empresa: Hotel = Pamplona Palace=20 Ltda.

Período: 1984 = até=20 1986.

Cargo: Gerente de = hospedagem.

Empresa: Mod. = Serviços S/C=20 Ltda. (MK. Analise de sistemas s/a Ltda.).

Período: 1983 = até=20 1984.

Cargo: Programador de = computador=20 (Cobol).

Empresa: = Confecções=20 Ilanit ltda.

Período: 1978 = até=20 1983.

Cargo: Gerente.

Empresa: Arno S/A. = Ind. e Com de=20 Eletrodomésticos.

Período: 1977 = até=20 1978.

Cargo: = Cronotécnico.

Empresa: Noruega Ind. = e Com. de=20 Malhas ltda.

Período: 1976 = até=20 1977.

Cargo: Chefe de = tempos e=20 métodos.

Informação=20 profissional.

Micro Pentium - ll = 300 com 64 Mb=20 de RAM, impressora Cannon BJC - 4000 jato de tinta, placa de Fax-Modem = U.S=20 Robotics 28.800, Windows 95 e Office 97. Conhecimentos de Trados.

Escolaridade.

Instituto Nacional de = Produção e Produtividade

Faculdade de = Tecnologia e=20 Engenharia de Produção

Formação em 1972 em=20 Tecnologia de Produção

Local: = Tel-Aviv.(Israel).

Medidas de Tempos = &=20 Métodos (M.T.M - I)

Escola: The British = Methods-Time=20 Measurement Association Limited

Duração = do curso:=20 12 meses

Certificado de = Analista de=20 Medidas de Tempos dos Métodos

Local: Londres, em = 1974.

Francês=20 contemporâneo

Escola: = Aliança Francesa=20 de Paris (França)

Certificado de = francês=20 4º grau da Aliança Francesa e Certificait de Français = Pratique da Sorbonne em 1975

Local: Paris = (França).

Medidas de Tempos = &=20 Métodos (M.T.M - II)

Escola: SENAI

Duração = do curso:=20 quatro meses

Certificado de = Analista de Tempos=20 & Métodos - II

Local: São = Paulo, em=20 1978.

Programação=20 Cobol

Escola: Servimec

Duração = do curso:=20 oito meses

Local: São = Paulo, em=20 1982.

Organização &=20 Métodos

Escola: Datamec

Duração = do curso:=20 quatro meses, local: São Paulo, em 1985.

Curso de Dos, = Windows, Word e=20 Excel

Escola: Data Sell

Duração: 60 horas=20 em 1997

Local: São = Paulo.

Curso de = Redação e=20 Atualização Gramatical

Escola: Verbum

Duração: 2 meses em=20 09/10 de 1999

Local: são = Paulo.

Oficina de = Tradução=20 e Versão

Escola: Pontifica = Universidade=20 Católica de São Paulo

Duração: 2 meses,=20 em andamento.

Local: São = Paulo.

Idiomas.

Inglês, = Francês,=20 Hebraico

------=_NextPart_000_00E4_01BFB03C.CEE7FE60-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 7:43: 7 2000 Delivered-To: freebsd-doc@freebsd.org Received: from pluton.univ-troyes.fr (pluton.univ-troyes.fr [193.50.230.240]) by hub.freebsd.org (Postfix) with ESMTP id 9426C37B965 for ; Thu, 27 Apr 2000 07:42:48 -0700 (PDT) (envelope-from stanislav.koschinsky@univ-troyes.fr) Received: from koschins.univtroyes.fr (kolokolov.univ-troyes.fr [193.50.230.246]) by pluton.univ-troyes.fr (8.9.1a/jtpda-5.3.1) with SMTP id QAA22123 for ; Thu, 27 Apr 2000 16:39:14 +0100 (WET DST) Message-ID: <000801bfb056$939ed800$f6e632c1@univtroyes.fr> From: "Koschinsky Stanislav" To: Subject: Maybe need to be corrected? Date: Thu, 27 Apr 2000 16:40:19 +0200 MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_NextPart_000_0005_01BFB067.462AE6C0" 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_01BFB067.462AE6C0 Content-Type: text/plain; charset="koi8-r" Content-Transfer-Encoding: quoted-printable Hello! My name is Stanislav Koschinsky. I've read the part of FreeBSD book 21.3 "DMA: What it is and how it = works". I like it very much. But I suppose that there is a mistakes (or = misprints maybe) in descriptions of "DMA Address and Count Registers" = and "DMA command registers". The numbers of registers does not = correspond ones that are in the description of IBM compaitible XT = computer. (DMA Registers: 0x2, 0x4, 0x6 etc.) I think there should be something like this: 0x0 write/read Channel 0 starting/current address 0x2 write/read Channel 1 starting/current address 0x4 write/read Channel 2 starting/current address 0x6 write/read Channel 3 starting/current address 0x1 write/read Channel 0 starting/remaining byte count 0x3 write/read Channel 1 starting/remaining byte count 0x5 write/read Channel 2 starting/remaining byte count 0x7 write/read Channel 3 starting/remaining byte count 0x8 write/read command register 0x9 write request register ... Please, verify the numbers. With best regards, S.Koschinsky. e-mail: koschinsky@univ-troyes.fr ------=_NextPart_000_0005_01BFB067.462AE6C0 Content-Type: text/html; charset="koi8-r" Content-Transfer-Encoding: quoted-printable
Hello!
My name is Stanislav = Koschinsky.
I've read the part of FreeBSD book 21.3 = "DMA: What=20 it is and how it works". I like it very much. But I suppose that there = is a=20 mistakes (or misprints maybe) in descriptions of "DMA Address and Count=20 Registers" and "DMA command registers". The numbers of registers does = not=20 correspond ones that are in the description of IBM compaitible XT = computer.=20 (DMA Registers: 0x2, 0x4, 0x6 etc.)
 
I think there should be something like=20 this:
 
0x0 write/read Channel 0 = starting/current=20 address
0x2 write/read Channel 1 = starting/current=20 address
0x4 write/read Channel 2 = starting/current=20 address
0x6 write/read Channel 3 = starting/current=20 address
0x1 write/read Channel 0 = starting/remaining=20 byte count
0x3 write/read Channel 1 = starting/remaining=20 byte count
0x5 write/read Channel 2 = starting/remaining=20 byte count
0x7 write/read Channel 3 = starting/remaining=20 byte count
 
0x8 write/read command = register
0x9 write request register
...
Please, verify the = numbers.
 
 
With best regards,
S.Koschinsky.
e-mail: koschinsky@univ-troyes.fr
 
------=_NextPart_000_0005_01BFB067.462AE6C0-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 7:56:32 2000 Delivered-To: freebsd-doc@freebsd.org Received: from web3207.mail.yahoo.com (web3207.mail.yahoo.com [204.71.202.204]) by hub.freebsd.org (Postfix) with SMTP id 504DF37B965 for ; Thu, 27 Apr 2000 07:56:30 -0700 (PDT) (envelope-from p_kuts@yahoo.com) Message-ID: <20000427145629.14805.qmail@web3207.mail.yahoo.com> Received: from [152.158.104.61] by web3207.mail.yahoo.com; Thu, 27 Apr 2000 07:56:28 PDT Date: Thu, 27 Apr 2000 07:56:28 -0700 (PDT) From: Pavel Kuts Subject: I Have A Question To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Can you tell me if I can use freebsd & window$ on the same machine? Thank You p_kuts@yahoo.com __________________________________________________ Do You Yahoo!? Talk to your friends online and get email alerts with Yahoo! Messenger. http://im.yahoo.com/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 17:19:50 2000 Delivered-To: freebsd-doc@freebsd.org Received: from exchange.gric.com (exchange.gric.com [207.20.139.7]) by hub.freebsd.org (Postfix) with ESMTP id B71C837BB96 for ; Thu, 27 Apr 2000 17:19:47 -0700 (PDT) (envelope-from screspi@gric.com) Received: from gric.com ([207.20.127.199]) by exchange.gric.com with SMTP (Microsoft Exchange Internet Mail Service Version 5.5.2650.21) id JBZBWVYK; Thu, 27 Apr 2000 17:24:52 -0700 Message-ID: <3908DA70.4C30B53E@gric.com> Date: Thu, 27 Apr 2000 17:25:20 -0700 From: Sylvia Crespi Reply-To: crespi40@hotmail.com X-Mailer: Mozilla 4.7 [en] (WinNT; I) X-Accept-Language: en,pdf MIME-Version: 1.0 To: freebsd-doc@FreeBSD.ORG Subject: tcl Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Is tcl/tk have any similarities to BSD?? screspi@gric.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 17:25:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from orion.ac.hmc.edu (Orion.AC.HMC.Edu [134.173.32.20]) by hub.freebsd.org (Postfix) with ESMTP id 0533737BC72 for ; Thu, 27 Apr 2000 17:25:32 -0700 (PDT) (envelope-from brdavis@orion.ac.hmc.edu) Received: (from brdavis@localhost) by orion.ac.hmc.edu (8.8.8/8.8.8) id RAA08509; Thu, 27 Apr 2000 17:25:28 -0700 (PDT) Date: Thu, 27 Apr 2000 17:25:28 -0700 From: Brooks Davis To: crespi40@hotmail.com Cc: freebsd-doc@FreeBSD.ORG Subject: Re: tcl Message-ID: <20000427172528.A6960@orion.ac.hmc.edu> References: <3908DA70.4C30B53E@gric.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre4i In-Reply-To: <3908DA70.4C30B53E@gric.com>; from screspi@gric.com on Thu, Apr 27, 2000 at 05:25:20PM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Apr 27, 2000 at 05:25:20PM -0700, Sylvia Crespi wrote: > Is tcl/tk have any similarities to BSD?? They are both Open Source software. That's about it. TCL is the Tool Control Language which is a scripting language designed to hooking various program together. TK is a GUI toolkit which works fairly well, is widely used, and is really quite ugly by modern standards. BSD is a UNIX like operating system. -- Brooks -- Any statement of the form "X is the one, true Y" is FALSE. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Thu Apr 27 17:31:37 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rock.ghis.net (rock.ghis.net [209.222.164.7]) by hub.freebsd.org (Postfix) with ESMTP id 2A95D37BC03 for ; Thu, 27 Apr 2000 17:31:36 -0700 (PDT) (envelope-from will@blackdawn.com) Received: from argon.blackdawn.com (04-128.dial.008.popsite.net [209.69.197.128]) by rock.ghis.net (8.9.3/8.9.3) with ESMTP id RAA66747; Thu, 27 Apr 2000 17:31:30 -0700 (PDT) Received: by argon.blackdawn.com (Postfix, from userid 1000) id 2FBA118E6; Thu, 27 Apr 2000 20:30:53 -0400 (EDT) Date: Thu, 27 Apr 2000 20:30:53 -0400 From: Will Andrews To: Brooks Davis Cc: crespi40@hotmail.com, freebsd-doc@FreeBSD.ORG Subject: Re: tcl Message-ID: <20000427203053.E546@argon.blackdawn.com> References: <3908DA70.4C30B53E@gric.com> <20000427172528.A6960@orion.ac.hmc.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000427172528.A6960@orion.ac.hmc.edu>; from brooks@one-eyed-alien.net on Thu, Apr 27, 2000 at 05:25:28PM -0700 X-Operating-System: FreeBSD 5.0-CURRENT i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Apr 27, 2000 at 05:25:28PM -0700, Brooks Davis wrote: > They are both Open Source software. That's about it. TCL is the Tool > Control Language which is a scripting language designed to hooking Tool Command Language. :-) -- Will Andrews GCS/E/S @d- s+:+>+:- a--->+++ C++ UB++++ P+ L- E--- W+++ !N !o ?K w--- ?O M+ V-- PS+ PE++ Y+ PGP+>+++ t++ 5 X++ R+ tv+ b++>++++ DI+++ D+ G++>+++ e->++++ h! r-->+++ y? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 1: 3:51 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mta5.snfc21.pbi.net (mta5.snfc21.pbi.net [206.13.28.241]) by hub.freebsd.org (Postfix) with ESMTP id 665A137B63E for ; Fri, 28 Apr 2000 01:03:45 -0700 (PDT) (envelope-from bill@2ez.com) Received: from Cynthia ([63.198.47.239]) by mta5.snfc21.pbi.net (Sun Internet Mail Server sims.3.5.2000.01.05.12.18.p9) with SMTP id <0FTP00JUCV9XVF@mta5.snfc21.pbi.net> for doc@FreeBSD.org; Fri, 28 Apr 2000 00:54:02 -0700 (PDT) Date: Fri, 28 Apr 2000 00:44:50 -0700 From: bill Subject: handbook submissions X-Sender: bill1@pop.winterlink.net To: doc@FreeBSD.org Message-id: <3.0.6.32.20000428004450.007f4370@pop.winterlink.net> MIME-version: 1.0 X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.6 (32) Content-type: text/plain; charset="us-ascii" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, we're newbies. we really screwed-up...caught it just in time, too. thought it might make for a good tidbit for the handbook. perhaps it will fit-in somewhere. bill ------- FreeBSD, disk drives and your BIOS Before you install and configure FreeBSD on your system, there is an important subject that you should be aware of if, especially if you have multiple hard drives. This is the subject of "BIOS drive numbering." In a PC running DOS or any of the BIOS-dependent operating systems (WINxxx), the BIOS is able to abstract the normal disk drive order, and the operating system goes along with the change. This allows the user to boot from a disk drive other than the so-called "primary master." This is especially convenient for some users who have found that the simplest and cheapest way to keep a system backup is to buy an identical second hard drive, and perform routine copies of the first drive to the second drive using Ghost or XCOPY /c/h/e/k/y/r. Then, if the first drive fails, or is attacked by a virus, or is scribbled upon by an operating system defect, he can easily recover by instructing the BIOS to logically swap the drives. It's like switching the cables on the drives, but without having to open the case. More expensive systems with SCSI controllers often include BIOS extensions which allow the SCSI drives to be re-ordered in a similar fashion for up to seven drives. A user who is accustomed to taking advantage of these features may become surprised when the results with FreeBSD are not as expected. FreeBSD does not use the BIOS, and does not know the "logical BIOS drive mapping." This can lead to very perplexing situations, especially when drives are physically identical in geometry, and have also been made as data clones of one another. When using FreeBSD, always restore the BIOS to natural drive numbering before installing FreeBSD, and then leave it that way. If you need to switch drives around, then do so, but do it the hard way...open the case and move the jumpers and cables. An illustration from the files of Bill and Fred's Exceptional Adventures: Bill breaks-down an older WIntel box to make another FreeBSD box for Fred. Bill installs a single SCSI drive as SCSI unit zero, and installs FreeBSD on it. Fred begins using the system, but after several days notices that the older SCSI drive is reporting numerous soft errors, and reports this fact to Bill. After several more days, Bill decides it's time to address the situation, so he grabs an identical SCSI drive from the disk drive "archive" in the back room. An initial surface scan indicates that this drive is functioning well, so Bill installs this drive as SCSI unit four, and makes an image copy from drive zero to drive four. Now that the new drive is installed and functioning nicely, Bill decides that it's a good idea to start using it, so he uses features in the SCSI BIOS to re-order the disk drives so that the system boots from SCSI unit four. FreeBSD boots and runs just fine. Fred continues his work for several days, and soon Bill and Fred decide that it's time for a new adventure -- time to upgrade to a newer version of FreeBSD. Bill removes SCSI unit zero because it was a bit flakey, and replaces it with another identical disk drive from the "archive." Bill then installs the new version of FreeBSD onto the new SCSI unit zero using Fred's magic internet FTP floppies. The installation goes well. Fred uses the new version of FreeBSD for a few days, and certifies that it is good enough for use in the engineering department...it's time to copy all of his work from the old version. So Fred mounts SCSI unit four (the latest copy of the older FreeBSD version). Fred is dismayed to find that none of his precious work is present on SCSI unit four. Where Did The Data GO???? When Bill made an image copy of the original SCSI unit zero onto SCSI unit four, unit four became the "new clone," When Bill re-ordered the SCSI BIOS so that he could boot from SCSI unit four, he was only fooling himself. FreeBSD was still running on SCSI unit zero. Making this kind of BIOS change will cause some or all of the Boot and Loader code to be fetched from the selected BIOS drive, but when the FreeBSD kernel drivers take-over, the BIOS drive numbering will be ignored, and FreeBSD will transition back to normal drive numbering. In the illustration at hand, the system continued to operate on the original SCSI unit zero, and all of Fred's data was there, not on SCSI unit four. The fact that the system appeared to be running on SCSI unit four was simply an artifact of human expectations. We are delighted to mention that no data bytes were killed or harmed in any way by our discovery of this phenomenon. The older SCSI unit zero was retrieved from the bonepile, and all of Fred's work was returned to him, (and now Bill knows that he can count as high as zero). Although SCSI drives were used in this illustration, the concepts apply equally to IDE drives. (If God had wanted you to have a BIOS, you would have been born with one.) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 4:18:16 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mailgate.originative.co.uk (mailgate.originative.co.uk [194.217.50.228]) by hub.freebsd.org (Postfix) with ESMTP id 96A9737B7CF; Fri, 28 Apr 2000 04:18:13 -0700 (PDT) (envelope-from paul@originative.co.uk) Received: from originative.co.uk (lobster.originative.co.uk [194.217.50.241]) by mailgate.originative.co.uk (Postfix) with ESMTP id C32741D160; Fri, 28 Apr 2000 12:18:09 +0100 (BST) Message-ID: <39097371.ADC7DD5F@originative.co.uk> Date: Fri, 28 Apr 2000 12:18:09 +0100 From: "Paul Richards.width" Organization: Originative Solutions Ltd X-Mailer: Mozilla 4.7 [en] (X11; I; FreeBSD 5.0-CURRENT i386) X-Accept-Language: en-GB, en MIME-Version: 1.0 To: Nik Clayton Cc: doc@freebsd.org Subject: Re: Default path settings References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik Clayton wrote: > > On Fri, Apr 21, 2000 at 01:55:47PM +0100, Paul Richards wrote: > > I'd like to suggest the following change. It makes it easier to use > > docbook for writing your own docs without having to worry about setting > > up lots of variables. You can still overide it if you want ot use a > > different .dsl file. > > > > > > diff -r1.10 doc.docbook.mk > > 52,53c52,53 > > < DSLHTML?= ${.CURDIR}/../../share/sgml/freebsd.dsl > > < DSLPRINT?= ${.CURDIR}/../../share/sgml/freebsd.dsl > > --- > > > DSLHTML?= ${DOC_PREFIX}/share/sgml/freebsd.dsl > > > DSLPRINT?= ${DOC_PREFIX}/share/sgml/freebsd.dsl > > No. At least, not in the form above. > > The lines you want to replace are looking for the freebsd.dsl file in > doc//share/sgml/freebsd.dsl, and not doc/share/sgml/freebsd.dsl > (which is what your patch would do). > > This is because each language has its own .dsl file, so that we can > keep per-language customisations separate. Ok, I understand what this is doing now I've looked. Why not have each language define a variable, rather than making the default so path specific? Then you could do DSLHTML?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl DSLPRINT?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl and if you don't define LANG then you'll pick up the defaults. It's a small increase in the size of the foreign language makefiles but makes it's much more straightforward to create docbook projects outside of the doc structure. It also allows deeper directory structures for document sources in the official docs tree, which the current model doesn't support. Paul. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 5:14:38 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 DFE6537BE9C; Fri, 28 Apr 2000 05:14:26 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 12l9eu-0009i2-00; Fri, 28 Apr 2000 14:14:12 +0200 Date: Fri, 28 Apr 2000 14:14:12 +0200 From: Neil Blakey-Milner To: "Paul Richards.width" Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default path settings Message-ID: <20000428141411.A37182@mithrandr.moria.org> References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org> <39097371.ADC7DD5F@originative.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <39097371.ADC7DD5F@originative.co.uk>; from paul@originative.co.uk on Fri, Apr 28, 2000 at 12:18:09PM +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-04-28 (12:18), Paul Richards.width wrote: > Why not have each language define a variable, rather than making the > default so path specific? It already does. > Then you could do > > DSLHTML?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl > DSLPRINT?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl That's what I'm about to do. Take a look back in the cvs history of doc.docbook.mk and you'll have a clearer picture.. Anyway, Jeroen has forgotten to bug me, so it's taken me time - I'll be "fixing" it this weekend. Neil -- Neil Blakey-Milner Hacker In Chief, 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 Apr 28 5:27:19 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mailgate.originative.co.uk (mailgate.originative.co.uk [194.217.50.228]) by hub.freebsd.org (Postfix) with ESMTP id 2DD0637B91C; Fri, 28 Apr 2000 05:27:16 -0700 (PDT) (envelope-from paul@originative.co.uk) Received: from originative.co.uk (lobster.originative.co.uk [194.217.50.241]) by mailgate.originative.co.uk (Postfix) with ESMTP id E7A921D160; Fri, 28 Apr 2000 13:27:09 +0100 (BST) Message-ID: <3909839D.881F1015@originative.co.uk> Date: Fri, 28 Apr 2000 13:27:09 +0100 From: "Paul Richards.width" Organization: Originative Solutions Ltd X-Mailer: Mozilla 4.7 [en] (X11; I; FreeBSD 5.0-CURRENT i386) X-Accept-Language: en-GB, en MIME-Version: 1.0 To: Neil Blakey-Milner Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default path settings References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org> <39097371.ADC7DD5F@originative.co.uk> <20000428141411.A37182@mithrandr.moria.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Neil Blakey-Milner wrote: > > On Fri 2000-04-28 (12:18), Paul Richards.width wrote: > > Why not have each language define a variable, rather than making the > > default so path specific? > > It already does. I couldn't find one anywhere or I wouldn't have suggested it :-) > > Then you could do > > > > DSLHTML?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl > > DSLPRINT?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl > > That's what I'm about to do. Take a look back in the cvs history of > doc.docbook.mk and you'll have a clearer picture.. I read all the log history but it doesn't actually say much about this. Paul. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 5:42:32 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 5106837B992; Fri, 28 Apr 2000 05:42:26 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 12lA6A-0009mD-00; Fri, 28 Apr 2000 14:42:22 +0200 Date: Fri, 28 Apr 2000 14:42:22 +0200 From: Neil Blakey-Milner To: "Paul Richards.width" Cc: Nik Clayton , doc@freebsd.org Subject: Re: Default path settings Message-ID: <20000428144221.B37182@mithrandr.moria.org> References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org> <39097371.ADC7DD5F@originative.co.uk> <20000428141411.A37182@mithrandr.moria.org> <3909839D.881F1015@originative.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <3909839D.881F1015@originative.co.uk>; from paul@originative.co.uk on Fri, Apr 28, 2000 at 01:27:09PM +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-04-28 (13:27), Paul Richards.width wrote: > > It already does. > > I couldn't find one anywhere or I wouldn't have suggested it :-) LANGCODE. It's ugly, though. I don't know what I was thinking ;) > > That's what I'm about to do. Take a look back in the cvs history of > > doc.docbook.mk and you'll have a clearer picture.. > > I read all the log history but it doesn't actually say much about this. diff -r1.8 -r1.9 doc.docbook.mk -DSLHTML?= ${DOC_PREFIX}/share/sgml/freebsd.dsl -DSLPRINT?= ${DOC_PREFIX}/share/sgml/freebsd.dsl +DSLHTML?= ../../share/sgml/freebsd.dsl +DSLPRINT?= ../../share/sgml/freebsd.dsl It used to work better for out-of-tree builds (which I, and some of my converts, use a lot, and think is a nifty thing to have around). Neil -- Neil Blakey-Milner Hacker In Chief, 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 Apr 28 5:44:40 2000 Delivered-To: freebsd-doc@freebsd.org Received: from columbus.cris.net (columbus.cris.net [212.110.128.65]) by hub.freebsd.org (Postfix) with ESMTP id 6F7E137BEC6; Fri, 28 Apr 2000 05:44:20 -0700 (PDT) (envelope-from phantom@ark.cris.net) Received: from ark.cris.net (root@ark.cris.net [212.110.128.68]) by columbus.cris.net (8.9.3/8.9.3) with ESMTP id PAA64031; Fri, 28 Apr 2000 15:43:52 +0300 (EEST) Received: (from phantom@localhost) by ark.cris.net (8.9.3/8.9.3) id PAA55756; Fri, 28 Apr 2000 15:43:58 +0300 (EEST) (envelope-from phantom) Date: Fri, 28 Apr 2000 15:43:58 +0300 From: Alexey Zelkin To: Neil Blakey-Milner Cc: "Paul Richards.width" , Nik Clayton , doc@FreeBSD.ORG Subject: Re: Default path settings Message-ID: <20000428154358.A51926@ark.cris.net> References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org> <39097371.ADC7DD5F@originative.co.uk> <20000428141411.A37182@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20000428141411.A37182@mithrandr.moria.org>; from nbm@mithrandr.moria.org on Fri, Apr 28, 2000 at 02:14:12PM +0200 X-Operating-System: FreeBSD 3.4-STABLE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Fri, Apr 28, 2000 at 02:14:12PM +0200, Neil Blakey-Milner wrote: > > Why not have each language define a variable, rather than making the > > default so path specific? > > It already does. > > > Then you could do > > > > DSLHTML?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl > > DSLPRINT?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl > > That's what I'm about to do. Take a look back in the cvs history of > doc.docbook.mk and you'll have a clearer picture.. > > Anyway, Jeroen has forgotten to bug me, so it's taken me time - I'll be > "fixing" it this weekend. One request -- before doing anything like that -- you'll request patches review. I like idea about improving the style, but often it causes breakages. And almost all of these breakages are avoidable. PS: I already twice fixed freebsd.dsl for russian doc/ tree and I don't want to do it again. -- /* Alexey Zelkin && phantom@cris.net */ /* Tavric National University && phantom@crimea.edu */ /* http://www.ccssu.crimea.ua/~phantom && phantom@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 Apr 28 8:10: 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 7839637BF3C for ; Fri, 28 Apr 2000 08:10:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id IAA11890; Fri, 28 Apr 2000 08:10:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id A4B0A37B51E for ; Fri, 28 Apr 2000 08:07:50 -0700 (PDT) (envelope-from mwlucas@blackhelicopters.org) Received: (from mwlucas@localhost) by blackhelicopters.org (8.9.3/8.9.3) id LAA75402; Fri, 28 Apr 2000 11:07:46 -0400 (EDT) (envelope-from mwlucas) Message-Id: <200004281507.LAA75402@blackhelicopters.org> Date: Fri, 28 Apr 2000 11:07:46 -0400 (EDT) From: mwlucas@blackhelicopters.org Reply-To: mwlucas@blackhelicopters.org To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18272: mount (8) references non-existent man page Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18272 >Category: docs >Synopsis: mount (8) references non-existent man 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 Apr 28 08:10:02 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Michael Lucas >Release: FreeBSD 5.0-current i386 >Organization: Yeah, right >Environment: 5.0-current system, supped a few days ago. >Description: The SEE ALSO section references mount_lfs (8). Can't find such a man page. moneysink~;apropos mount_lfs mount_lfs: nothing appropriate moneysink~;locate mount_lfs moneysink~;locate -i mount_lfs moneysink~; (Man, I don't have enough time to notice things like this. But reading man pages is far more entertaining than working.) >How-To-Repeat: man 8 mount >Fix: Remove reference to mount_lfs(8), build a mount_lfs man page, or reference the correct page. >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 Apr 28 12:17:27 2000 Delivered-To: freebsd-doc@freebsd.org Received: from littleb.mhpcc.edu (littleb.mhpcc.edu [164.122.25.41]) by hub.freebsd.org (Postfix) with ESMTP id 56B7137BF40 for ; Fri, 28 Apr 2000 12:17:25 -0700 (PDT) (envelope-from jeffr@mhpcc.edu) Received: from mhpcc.edu (poki.mhpcc.edu [164.122.30.205]) by littleb.mhpcc.edu (8.8.7/8.8.7) with ESMTP id JAA13124 for ; Fri, 28 Apr 2000 09:17:08 -1000 Message-ID: <3909E3BF.D04ED08F@mhpcc.edu> Date: Fri, 28 Apr 2000 09:17:19 -1000 From: Jeff Ramacher Organization: MHPCC X-Mailer: Mozilla 4.6 [en] (X11; I; FreeBSD 3.1-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Java links in Japanese? Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Are the following web pages (links on the main FreeBSD Java Project home page) going to remain in Japanese language format from now on? Release Information JDK 1.1.x JDK 1.2.x JDK 1.3.x  Thanks in advance :-) -- Jeff Ramacher (jeffr@mhpcc.edu) | (808) 879-5077, x264 Maui High Performance Computing Center (MHPCC) | fax (808) 879-5018 | http://www.mhpcc.edu To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 12:37:32 2000 Delivered-To: freebsd-doc@freebsd.org Received: from columbus.cris.net (columbus.cris.net [212.110.128.65]) by hub.freebsd.org (Postfix) with ESMTP id E07C437B939 for ; Fri, 28 Apr 2000 12:37:24 -0700 (PDT) (envelope-from phantom@ark.cris.net) Received: from ark.cris.net (root@ark.cris.net [212.110.128.68]) by columbus.cris.net (8.9.3/8.9.3) with ESMTP id WAA21561; Fri, 28 Apr 2000 22:37:01 +0300 (EEST) Received: (from phantom@localhost) by ark.cris.net (8.9.3/8.9.3) id WAA28121; Fri, 28 Apr 2000 22:37:08 +0300 (EEST) (envelope-from phantom) Date: Fri, 28 Apr 2000 22:37:08 +0300 From: Alexey Zelkin To: Jeff Ramacher Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Java links in Japanese? Message-ID: <20000428223708.A27511@ark.cris.net> References: <3909E3BF.D04ED08F@mhpcc.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Mailer: Mutt 1.0i In-Reply-To: <3909E3BF.D04ED08F@mhpcc.edu>; from jeffr@mhpcc.edu on Fri, Apr 28, 2000 at 09:17:19AM -1000 X-Operating-System: FreeBSD 3.4-STABLE i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, On Fri, Apr 28, 2000 at 09:17:19AM -1000, Jeff Ramacher wrote: > Are the following web pages (links on the main FreeBSD Java Project home > page) going to remain in Japanese language format from now on? > =20 > Release Information > JDK 1.1.x > JDK 1.2.x > JDK 1.3.x =18 It was caused by incorrect Makefile imported by Japanese people few days ago. Problem is already fixed. --=20 /* Alexey Zelkin && phantom@cris.net */ /* Tavric National University && phantom@crimea.edu */ /* http://www.ccssu.crimea.ua/~phantom && phantom@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 Apr 28 14:54:54 2000 Delivered-To: freebsd-doc@freebsd.org Received: from kira.epconline.net (kira.epconline.net [209.83.132.2]) by hub.freebsd.org (Postfix) with ESMTP id 8B9B237BA3D for ; Fri, 28 Apr 2000 14:54:52 -0700 (PDT) (envelope-from carock@epctech.com) Received: from therock (borkstation.epconline.net [209.83.132.11]) by kira.epconline.net (8.9.3/8.9.3) with SMTP id QAA61837 for ; Fri, 28 Apr 2000 16:54:47 -0500 (CDT) Reply-To: From: "Chuck Rock" To: Subject: New 4.0 features documentation... Date: Fri, 28 Apr 2000 17:01:30 -0500 Message-ID: <001301bfb15d$4efb2520$0200000a@epconline.net> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook 8.5, Build 4.71.2173.0 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.6600 Importance: Normal Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org When/will there be a new release of the handbook to relfect the new features in FreeBSD 4.0? your search engine on your web site when searching for "jail" only returns one page about porting your own applications. Thanks, Chuck To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Fri Apr 28 16:15:31 2000 Delivered-To: freebsd-doc@freebsd.org Received: from luna.cdrom.com (luna.cdrom.com [204.216.28.135]) by hub.freebsd.org (Postfix) with ESMTP id 3D69637B9E0 for ; Fri, 28 Apr 2000 16:15:30 -0700 (PDT) (envelope-from jim@luna.cdrom.com) Received: by luna.cdrom.com (Postfix, from userid 1000) id A91EA31F4; Fri, 28 Apr 2000 16:15:29 -0700 (PDT) Date: Fri, 28 Apr 2000 16:15:29 -0700 From: Jim Mock To: Chuck Rock Cc: doc@FreeBSD.ORG Subject: Re: New 4.0 features documentation... Message-ID: <20000428161529.B41443@luna.cdrom.com> Reply-To: jim@luna.cdrom.com References: <001301bfb15d$4efb2520$0200000a@epconline.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.1.12i In-Reply-To: <001301bfb15d$4efb2520$0200000a@epconline.net>; from carock@epctech.com on Fri, Apr 28, 2000 at 05:01:30PM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, 28 Apr 2000 at 17:01:30 -0500, Chuck Rock wrote: > When/will there be a new release of the handbook to relfect the new > features in FreeBSD 4.0? The handbook is an ever-changing document. If the things you're looking for aren't covered, it's because someone with enough clue on the particular subject hasn't written anything and submitted it for inclusion. > your search engine on your web site when searching for "jail" only > returns one page about porting your own applications. Searching the mailing list archives will probably get you better results. - jim -- - jim mock - walnut creek cdrom/freebsd test labs - jim@luna.cdrom.com - - phone: 1.925.691.2800 x.3814 - fax: 1.925.674.0821 - jim@FreeBSD.org - - editor - The FreeBSDzine - www.freebsdzine.org - jim@freebsdzine.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Apr 29 0:33:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from cec.vstu.vinnica.ua (cec.vstu.vinnica.ua [62.244.53.130]) by hub.freebsd.org (Postfix) with ESMTP id 0AE7D37B56B for ; Sat, 29 Apr 2000 00:33:22 -0700 (PDT) (envelope-from sunny@vstu.vinnica.ua) Received: from vstu.vinnica.ua (ppp3.vstu.vinnica.ua [62.244.53.163]) by cec.vstu.vinnica.ua (8.9.3/8.9.3) with ESMTP id KAA30247 for ; Sat, 29 Apr 2000 10:36:12 +0300 Message-ID: <390A8F98.6AF2907F@vstu.vinnica.ua> Date: Sat, 29 Apr 2000 07:30:32 +0000 From: Sunil Khandelwal X-Mailer: Mozilla 4.08 [en] (X11; I; Linux 2.0.36 i386) MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org Subject: I want to contribute to the FreeBSD Content-Type: text/plain; charset=us-ascii 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 Apr 29 2: 0: 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 59BB637B6F8 for ; Sat, 29 Apr 2000 02:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id CAA38577; Sat, 29 Apr 2000 02:00:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from ns1.tu-graz.ac.at (ns1.tu-graz.ac.at [129.27.2.3]) by hub.freebsd.org (Postfix) with ESMTP id 3F83D37B6DA for ; Sat, 29 Apr 2000 01:58:02 -0700 (PDT) (envelope-from mkamm@ns1.tu-graz.ac.at) Received: from localhost.tu-graz.ac.at (isdn113.tu-graz.ac.at [129.27.240.113]) by ns1.tu-graz.ac.at (8.9.3/8.9.3) with ESMTP id KAA21561 for ; Sat, 29 Apr 2000 10:55:11 +0200 (MET DST) Received: (from mkamm@localhost) by localhost.tu-graz.ac.at (8.9.3/8.9.3) id JAA02448; Fri, 28 Apr 2000 09:29:41 +0200 (CEST) (envelope-from mkamm) Message-Id: <200004280729.JAA02448@localhost.tu-graz.ac.at> Date: Fri, 28 Apr 2000 09:29:41 +0200 (CEST) From: dada@sbox.tu-graz.ac.at Reply-To: dada@sbox.tu-graz.ac.at To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18290: obsolete reference in programming tools article Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18290 >Category: docs >Synopsis: obsolete reference in programming tools article >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: Sat Apr 29 02:00:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Martin Kammerhofer >Release: FreeBSD 3.4-STABLE i386 >Organization: Graz University >Environment: >Description: In doc/en/articles/programming-tools/article.html I read: Perl Very popular with system administrators for writing scripts; also often used on World Wide Web servers for writing CGI scripts. Version 4, which is probably still the most widely-used version, comes with FreeBSD; the newer Perl Version 5 is available as a package. >How-To-Repeat: >Fix: Delete the reference to Perl 4. It was last shipped with FreeBSD in the days of FreeBSD 2.x.y. Now FreeBSD ships with Perl 5. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Apr 29 4:53:29 2000 Delivered-To: freebsd-doc@freebsd.org Received: from lucifer.bart.nl (lucifer.bart.nl [194.158.168.74]) by hub.freebsd.org (Postfix) with ESMTP id 29BF937B73A for ; Sat, 29 Apr 2000 04:53:24 -0700 (PDT) (envelope-from asmodai@lucifer.bart.nl) Received: (from asmodai@localhost) by lucifer.bart.nl (8.9.3/8.9.3) id NAA26256; Sat, 29 Apr 2000 13:53:14 +0200 (CEST) (envelope-from asmodai) Date: Sat, 29 Apr 2000 13:53:14 +0200 From: Jeroen Ruigrok van der Werven To: Mike Pritchard Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/18233: man and nroff -mdoc produce extra blank lines. Message-ID: <20000429135314.C25776@lucifer.bart.nl> References: <200004261720.KAA55939@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <200004261720.KAA55939@freefall.freebsd.org>; from mpp@mppsystems.com on Wed, Apr 26, 2000 at 10:20:02AM -0700 Organisation: VIA Net.Works The Netherlands Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org -On [20000426 19:35], Mike Pritchard (mpp@mppsystems.com) wrote: > The extra blank lines are at page breaks within the man page. > 66 lines of text is one printed page of output. 132 lines of text > is two pages of text, etc. What I am trying to understand in this issue is whether pages still get printed normally [in other formats or printer] when I remove the pagebreaking in the manpage display. Did that make sense? -- Jeroen Ruigrok van der Werven Network- and systemadministrator VIA Net.Works The Netherlands BSD: Technical excellence at its best http://www.via-net-works.nl Answering the questions that no one asks... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Apr 29 7: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 2D37A37B936 for ; Sat, 29 Apr 2000 07:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA72523; Sat, 29 Apr 2000 07:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from mailgw1.be.to (mailgw1.be.to [210.235.212.5]) by hub.freebsd.org (Postfix) with ESMTP id 658C937B677 for ; Sat, 29 Apr 2000 07:20:08 -0700 (PDT) (envelope-from okazaki@be.to) Received: from mail1.be.to (www.be.to [210.235.212.3]) by mailgw1.be.to (8.9.3+3.2W/BETO.2.1-2000042817000035) with ESMTP id XAA17135 for ; Sat, 29 Apr 2000 23:19:57 +0900 Received: from acidrain (ppp25-Mobara1.mtci.ne.jp [210.172.1.227]) by mail1.be.to (8.8.8+3.0Wbeta13/BETO.2.0-1999110714000000) with SMTP id XAA10942 for ; Sat, 29 Apr 2000 23:19:50 +0900 Received: (qmail 11508 invoked by uid 1001); 29 Apr 2000 14:17:44 -0000 Message-Id: <20000429141744.11507.qmail@dolphin.be.to> Date: 29 Apr 2000 14:17:44 -0000 From: okazaki@be.to Reply-To: okazaki@be.to To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18292: Bug in the ng_ether.8. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18292 >Category: docs >Synopsis: Bug in the ng_ether.8. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Apr 29 07:30:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: OKAZAKI Tetsurou >Release: FreeBSD 3.4-STABLE i386 >Organization: Unknown >Environment: $FreeBSD: src/share/man/man8/ng_ether.8,v 1.2 2000/03/24 01:49:43 mpp Exp $ >Description: In the ng_ether.8, a .Bl/.El pair is used for an example of a command line with the -literal type specifier. Therefore, groff prints the following error out: -literal Usage: .Bl [[-inset|-tag] -width] [-item|-enum|-bullet|-diag] (#102) when the page is formatted. >How-To-Repeat: % man -t ng_ether > /dev/null >Fix: Please apply the patch below to fix the manual. Index: ng_ether.8 =================================================================== RCS file: /home/ncvs/FreeBSD/src/share/man/man8/ng_ether.8,v retrieving revision 1.2 diff -u -r1.2 ng_ether.8 --- ng_ether.8 2000/03/24 01:49:43 1.2 +++ ng_ether.8 2000/04/29 13:17:42 @@ -99,10 +99,9 @@ This command will dump all packets received by the .Dv fxp0 interface to standard output as decoded hex and ASCII: -.Bl -literal - +.Bd -literal nghook -a fxp0: divert -.El +.Ed .Sh SEE ALSO .Xr arp 4 , .Xr netgraph 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 Sat Apr 29 9:14:34 2000 Delivered-To: freebsd-doc@freebsd.org Received: from intra.wish.net (intra.wish.net [212.123.130.23]) by hub.freebsd.org (Postfix) with SMTP id D0BAD37BA0C for ; Sat, 29 Apr 2000 09:14:31 -0700 (PDT) (envelope-from ron-asupervisor@intra.wish.net) Received: (qmail 6153 invoked from network); 29 Apr 2000 16:17:25 -0000 Received: from firestarter.wish.net (HELO stanenron) (212.123.130.13) by intra.wish.net with SMTP; 29 Apr 2000 16:17:25 -0000 Message-ID: <001201bfb1f5$fca467c0$2e01a8c0@stanenron> From: "Ron Verbossen" To: Subject: Translation Date: Sat, 29 Apr 2000 18:14:25 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit 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 Hi there, After reading through the FBSD handbook, I noticed some lines about your organisation needing people to translate texts to other languages. Personally I had no prob reading the English version, but I can quite well understand that some people like their native language better. I was just wondering if anybody is translating anything into Dutch already??? If not, let me no plz., and tell me what translation is most required. Thx, Ron Verbossen To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message From owner-freebsd-doc Sat Apr 29 15:59:33 2000 Delivered-To: freebsd-doc@freebsd.org Received: from elvis.mu.org (elvis.mu.org [207.154.226.10]) by hub.freebsd.org (Postfix) with ESMTP id 1BB5337B5B6 for ; Sat, 29 Apr 2000 15:59:32 -0700 (PDT) (envelope-from david@elvis.mu.org) Received: (from david@localhost) by elvis.mu.org (8.9.1/8.9.1) id RAA05785 for doc@freebsd.org; Sat, 29 Apr 2000 17:59:19 -0500 (CDT) (envelope-from david) Date: Sat, 29 Apr 2000 17:59:19 -0500 From: David Drum To: doc@freebsd.org Subject: Comment on http://www.freebsd.org/handbook/kernelconfig-config.html Message-ID: <20000429175919.A5640@elvis.mu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hello, The handbook at http://www.freebsd.org/handbook/kernelconfig-config.html reads: > To mount an MFS RAM disk on /tmp, add the following line to /etc/fstab: > > /dev/ad1s2b /tmp mfs rw 0 0 > > Now you simply need to either reboot, or run the command mount /tmp. I would like to make the following suggestion, that this be changed to read: > To mount an MFS RAM disk on /tmp, add the following line to /etc/fstab: > > /dev/ad1s2b /tmp mfs rw 0 0 > > Replace "/dev/ad1s2b" with the largest swap partition you have configured > on the system. The swapinfo(8) command will report all swap partitions. > Now you simply need to either reboot, or run the command mount /tmp. Regards, David Drum david@mu.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message