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 <freebsd-doc@freebsd.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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: <mpp@FreeBSD.org>
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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: doc@freebsd.org
Cc: ports@freebsd.org
Subject: man page for cscope (fwd)
Message-ID: <Pine.BSF.4.21.0004231757070.1475-200000@localhost.localdomain>
MIME-Version: 1.0
Content-Type: MULTIPART/Mixed; BOUNDARY="0-459701646-956529040=:1382"
Content-ID: <Pine.BSF.4.21.0004231757071.1475@localhost.localdomain>
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: <Pine.BSF.4.21.0004231757072.1475@localhost.localdomain>
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 <jestess@localhost.wcnet.net>
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: <Pine.BSF.4.21.0004231730400.1382@localhost.localdomain>
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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: doc@freebsd.org
Cc: ports@freebsd.org
Subject: cscope man page in text
Message-ID: <Pine.BSF.4.21.0004231822230.4517-100000@localhost.localdomain>
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 <Ctrl>-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 <Tab> key repeatedly to move to the desired input field,
type the text to search for, and then press the <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 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 <Tab> key repeatedly. If you have
<CLEAR>, <NEXT>, or <PREV> 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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 @@
<title>Changing your shell</title>
<para>The easiest way to change your shell is to use the
- <command>chsh</command>. Running <command>chsh</command> will
+ <command>chsh</command> command. Running <command>chsh</command> will
place you into the editor that is in your <envar>EDITOR</envar>
environment variable; if it is not set, you will be placed in
<command>vi</command>. Change the “Shell:” line
accordingly.</para>
<para>You can also give <command>chsh</command> the
- <option>-s</option> option; this will set the shell for you
- without having to enter the editor. For example, if you wanted to
+ <option>-s</option> 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:</para>
>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 <phantom@cris.crimea.ua>
To: John Estess <jestess@wcnet.net>
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 <phantom@cris.crimea.ua>
References: <Pine.BSF.4.21.0004231822230.4517-100000@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.7i
In-Reply-To: <Pine.BSF.4.21.0004231822230.4517-100000@localhost.localdomain>
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 <doc@FreeBSD.ORG>; 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 <doc@FreeBSD.ORG>; 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 <doc@FreeBSD.ORG>; 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 <okazaki@be.to>
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: <Pine.BSF.4.21.0004231822230.4517-100000@localhost.localdomain>
<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 <phantom@cris.crimea.ua> 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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: OKAZAKI Tetsurou <okazaki@be.to>
Cc: doc@FreeBSD.ORG, ports@FreeBSD.ORG
Subject: Re: cscope man page in text
In-Reply-To: <86g0scfqp6.wl@dolphin.be.to>
Message-ID: <Pine.BSF.4.21.0004231642280.7003-100000@localhost.localdomain>
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 <freebsd-doc@FreeBSD.ORG>; 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 <DougB@gorean.org>
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 <mbrown@corp.webb.net>
Cc: "'freebsd-doc@FreeBSD.ORG'" <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 (<meta http-equiv="Content-Type"
> 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:
<!doctype ... >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1">
<title>Foo</title>
</head>
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 <nik@freebsd.org>
To: Alexander Langer <alex@big.endian.de>, doc@freebsd.org
Cc: Nik Clayton <nik@FreeBSD.ORG>, 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 <URL:http://www.freebsd.org/>
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 <luigi@info.iet.unipi.it>
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 <speterson@virtation.com>
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 <freebsd-doc@freebsd.org>; 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 <bugmaster@freebsd.org>
To: FreeBSD doc list <freebsd-doc@freebsd.org>
Subject: Current unassigned doc problem reports
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org
Current FreeBSD problem reports
The following is a listing of current problems submitted by FreeBSD users.
These represent problem reports covering all versions including
experimental development code and obsolete releases.
Bugs can be in one of several states:
o - open
A problem report has been submitted, no sanity checking performed.
a - analyzed
The report has been examined by a team member and evaluated.
f - feedback
The problem has been solved, and the originator has been given a
patch or a fix has been committed. The PR remains in this state
pending a response from the originator.
s - suspended
The problem is not being worked on. This is a prime candidate
for somebody who is looking for a project to do.
If the problem cannot be solved at all,
it will be closed, rather than suspended.
c - closed
A problem report is closed when any changes have been integrated,
documented, and tested.
Critical problems
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 <freebsd-doc@freebsd.org>; 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 <freebsd-doc@freebsd.org>; Mon, 24 Apr 2000 15:26:56 -0400 (EDT)
From: EBaranova@aol.com
Message-ID: <c5.47fd73b.2635f9ff@aol.com>
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 <doc@FreeBSD.org>; 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 <nik@freebsd.org>
To: Sheldon Hearn <sheldonh@uunet.co.za>
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 <URL:http://www.freebsd.org/>
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.
<note>
<para>This has since been changed in FreeBSD. See <xref
linkend="aw-changes-foo"> for more details.</para>
</note>
Possibly without the surrounding <note>. Then have a
<sectn id="aw-changes">
<title>Changes in FreeBSD.</para>
<formalpara id="aw-changes-foo">
<title>Changes to the Foo Frobnicator</title>
<para>FreeBSD now has a unified Foo Frobnication mechanism, which
is more efficient than the split scheme described. . .</para>
</formalpara>
...
</sectn>
(where the 'n' in '<sectn>' is replaced with an appropriate number). That'd
be my first choice. Possibly wrapping an <itemizedlist> around all the
<formalpara>s as well.
In this instance they need to be <formalpara>, because they need a title.
Without a title, <xref ...> can't generate the text of the link correctly.
The alternative would be to use
... see <link linkend="aw-changes-foo">changes to the Foo
Frobnicator<link> for more details.</para>
[...]
<para id="aw-changes-foo">FreeBSD now has a unified ... </para>
which I don't like as much. I think each change should get its own
title -- <formalpara> lets you do that without giving each change its
own <sectn>, 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 <freebsd-doc@FreeBSD.ORG>; 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 <freebsd-doc@FreeBSD.ORG>; 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 <szmurlor@tmp.iem.pw.edu.pl>
To: freebsd-doc@FreeBSD.ORG
Subject: Polish documentation.
Message-ID: <Pine.BSF.4.21.0004251310500.7591-100000@tmp.iem.pw.edu.pl>
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 <doc@freebsd.org>; 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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: doc@freebsd.org
Subject: last time for mdoc corrections
Message-ID: <Pine.BSF.4.21.0004250712290.2757-100000@localhost.localdomain>
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 <Ctrl>-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 <Tab> key repeatedly to move to the desired input field,
type the text to search for, and then press the <Return> 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 <Space> -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 <Return> -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 <Space>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 <Tab> key repeatedly. If you have
<CLEAR>, <NEXT>, or <PREV> 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 <doc@freebsd.org>; 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 <sheldonh@uunet.co.za>
To: John Estess <jestess@wcnet.net>
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."
<Pine.BSF.4.21.0004250712290.2757-100000@localhost.localdomain>
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 <doc@FreeBSD.ORG>; 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 <mpp@mppsystems.com>
To: John Estess <jestess@wcnet.net>
Cc: doc@FreeBSD.ORG
Subject: Re: last time for mdoc corrections
Message-ID: <20000425084542.A50322@mppsystems.com>
References: <Pine.BSF.4.21.0004250712290.2757-100000@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0.1i
In-Reply-To: <Pine.BSF.4.21.0004250712290.2757-100000@localhost.localdomain>; 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 <Tab> key repeatedly to move to the desired input field,
type the text to search for, and then press the <Return> 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 <Space> -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: <sheldonh@FreeBSD.org>
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 <sheldonh@uunet.co.za>
To: Soren Schmidt <sos@freebsd.dk>
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 <freebsd-doc@freebsd.org>; 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 <sheldonh@uunet.co.za>
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 <freebsd-doc@freebsd.org>; 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 <freebsd-doc@freebsd.org>; Tue, 25 Apr 2000 14:07:07 -0300 (EST)
Content-Length: 935
Message-ID: <XFMail.000425140742.cess@matrix.com.br>
X-Mailer: XFMail 1.4.0 on FreeBSD
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
Date: Tue, 25 Apr 2000 14:07:42 -0300 (EST)
From: Carlos Eduardo Selonke de Souza <cess@matrix.com.br>
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: <jim@FreeBSD.org>
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 <sos@freebsd.dk>
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 <doc@freebsd.org>; 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 <doc@freebsd.org>; 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" <Mafiouso@most-wanted.com>
To: "doc@freebsd.org" <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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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: <E12kBxf-000FDS-00@magnesium.scientia.demon.co.uk>
Date: Tue, 25 Apr 2000 21:29:35 +0100
From: Ben Smithurst <ben@scientia.demon.co.uk>
Reply-To: ben@scientia.demon.co.uk
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/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 <doc@freebsd.org>; 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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: Mike Pritchard <mpp@mppsystems.com>
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: <Pine.BSF.4.21.0004251608190.3952-100000@localhost.localdomain>
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 <Ctrl>-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 <Tab> key repeatedly to move to the desired input field,
type the text to search for, and then press the <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 <Space> -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 <Return> -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 <Space>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 <Tab> key repeatedly. If you have
<CLEAR>, <NEXT>, or <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, ``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: <jkoshy@FreeBSD.org>
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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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" <tomdean@ix.netcom.com>
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 <<EOF
.Dd DATE
.Os
.Dt XX 1
.Sh NAME
.Nm xx
.Nd This will produce blank line errors.
EOF
section=0
paragraph=0
while [ $section -lt 10 ]; do
echo ".Sh Section Number ${section}"
section=`expr ${section} + 1`
n=0
while [ $n -lt 3 ]; do
echo "This is paragraph ${paragraph}."
echo ".Pp"
paragraph=`expr ${paragraph} + 1`
n=`expr $n + 1`
done
done
>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 <freebsd-doc@freebsd.org>; 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 <mpp@mppsystems.com>
Subject: Re: docs/18233: man and nroff -mdoc produce extra blank lines.
Reply-To: Mike Pritchard <mpp@mppsystems.com>
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 <mpp@mppsystems.com>
To: "Thomas D. Dean" <tomdean@ix.netcom.com>
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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <freebsd-doc@FreeBSD.ORG>; 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" <garth@cs.colorado.edu>
To: <freebsd-doc@FreeBSD.ORG>
Subject: Is FreeBSD a registered trademark?
Date: Wed, 26 Apr 2000 23:25:04 -0700
Message-ID: <NDBBIJLHPNABGBGJBLNNKEAACLAA.garth@cs.colorado.edu>
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 <freebsd-doc@freebsd.org>; 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 <sheldonh@uunet.co.za>
Subject: Re: docs/18243: a mistake in sh.1
Reply-To: Sheldon Hearn <sheldonh@uunet.co.za>
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 <sheldonh@uunet.co.za>
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 <freebsd-doc@freebsd.org>; 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 <mellon@pobox.com>
Subject: Re: docs/18243: a mistake in sh.1
Reply-To: Anatoly Vorobey <mellon@pobox.com>
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 <mellon@pobox.com>
To: Sheldon Hearn <sheldonh@uunet.co.za>
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 <doc@FreeBSD.ORG>; 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 <phantom@FreeBSD.org.ua>
To: John Estess <jestess@wcnet.net>
Cc: Mike Pritchard <mpp@mppsystems.com>, 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> <Pine.BSF.4.21.0004251608190.3952-100000@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0.1i
In-Reply-To: <Pine.BSF.4.21.0004251608190.3952-100000@localhost.localdomain>; 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 <doc@freebsd.org>; 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 <jestess@wcnet.net>
X-Sender: jestess@localhost.localdomain
To: Alexey Zelkin <phantom@FreeBSD.org.ua>
Cc: Mike Pritchard <mpp@mppsystems.com>, 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: <Pine.BSF.4.21.0004270813310.11829-100000@localhost.localdomain>
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 <Space> -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 <Return> -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 <Space>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 <freebsd-doc@FreeBSD.ORG>; 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 <freebsd-doc@FreeBSD.ORG>; Thu, 27 Apr 2000 11:33:12 -0300 (BRT)
Message-ID: <00e701bfb055$f5d8d440$2046bfc8@f.mor>
From: "fmor" <fmor@uol.com.br>
To: <freebsd-doc@FreeBSD.ORG>
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD W3 HTML//EN">
<HTML>
<HEAD>
<META content=3Dtext/html;charset=3Diso-8859-1 =
http-equiv=3DContent-Type>
<META content=3D'"MSHTML 4.72.3110.7"' name=3DGENERATOR>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV>
<P class=3DMsoNormal=20
style=3D"mso-margin-top-alt: auto; mso-margin-bottom-alt: auto; =
mso-pagination: widow-orphan; text-autospace: ideograph-numeric =
ideograph-other"><SPAN=20
lang=3DEN-GB style=3D"mso-ansi-language: EN-GB">Prezados Srs,</SPAN></P>
<P class=3DMsoNormal=20
style=3D"mso-margin-top-alt: auto; mso-margin-bottom-alt: auto"><SPAN =
lang=3DEN-GB=20
style=3D"mso-ansi-language: EN-GB">Por meio deste estou lhes enviando um =
resumo de=20
minhas atividades profissionais para sua devida=20
consideração.</SPAN></P>
<P align=3Dcenter class=3DMsoNormal=20
style=3D"TEXT-ALIGN: center; mso-margin-top-alt: auto; =
mso-margin-bottom-alt: auto"><B><SPAN=20
lang=3DEN-GB style=3D"FONT-SIZE: 11pt; mso-ansi-language: =
EN-GB">CURRICULUM=20
VITAE</SPAN></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Nome: Maurício =
Mor.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Rg. : 10.322.253; =
C.I.C:=20
874.685.908-00; CCM: 2.781.079-8.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Endereço: Rua =
Albuquerque=20
Lins, 107 Apto. 124 – a, Santa Cecília, São Paulo =
–=20
SP.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">CEP: 01230-000.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Telefax: (0xx11) =
825-4743;=20
Celular: (0xx11) 9303-4481.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">E-mail: =
fmor@uol.com.br.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Estado civil: =
casado.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Nacionalidade: =
brasileiro.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Data de nascimento:=20
26/11/1949.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><B><U><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify"><B><U>Ocupação=20
atual.<O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Atividade de =
<B>Free-Lancer</B>=20
em <B>traduções técnicas e gerais</B>, junto a CIT =
–=20
Centro Internacional de Traduções e Serviços S/C =
Ltda e a=20
Andrart Traduções S/C.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify"><B><U>Ocupações=20
anteriores.<O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Brasilfax- =
SP Com. Exp.=20
Imp. Ltda.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">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.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: =
01/1998=20
até 02/1999.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: All =
Tasks<SPAN=20
style=3D"FONT-FAMILY: Symbol; mso-ascii-font-family: Times New Roman; =
mso-hansi-font-family: Times New Roman; mso-char-type: symbol; =
mso-symbol-font-family: Symbol"><SPAN=20
style=3D"mso-char-type: symbol; mso-symbol-font-family: =
Symbol">â</SPAN></SPAN>=20
Traduções Técnicas, Editoração=20
Eletrônica e Software Localization.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: =
01/1996=20
até 01/1998.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: =
Revisor/Tradutor=20
técnico com ênfase nas áreas de=20
<B>telecomunicações, informática, mecânica, =
patentes,=20
e administração</B> de modo geral.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Arte-sul =
ind. e com.=20
Ltda.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1987 =
até=20
1995.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: =
Sócio-Gerente=20
Administrativo/Produção<SPAN=20
style=3D"FONT-FAMILY: Arial">.<O:P></O:P></SPAN></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Hotel =
Pamplona Palace=20
Ltda.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1984 =
até=20
1986.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: Gerente de =
hospedagem.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Mod. =
Serviços S/C=20
Ltda. (MK. Analise de sistemas s/a Ltda.).</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1983 =
até=20
1984.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: Programador de =
computador=20
(Cobol).</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: =
Confecções=20
Ilanit ltda. </P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1978 =
até=20
1983.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: Gerente.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Arno S/A. =
Ind. e Com de=20
Eletrodomésticos.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1977 =
até=20
1978.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: =
Cronotécnico.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Empresa: Noruega Ind. =
e Com. de=20
Malhas ltda.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Período: 1976 =
até=20
1977.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Cargo: Chefe de =
tempos e=20
métodos.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify"><B><U>Informação=20
profissional.<O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">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.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal=20
style=3D"TEXT-ALIGN: justify"><B><U>Escolaridade.<O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Instituto Nacional de =
Produção e Produtividade</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Faculdade de =
Tecnologia e=20
Engenharia de Produção </P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Formação em 1972 em=20
Tecnologia de Produção</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: =
Tel-Aviv.(Israel).</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Medidas de Tempos =
&=20
Métodos (M.T.M - I)</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: The British =
Methods-Time=20
Measurement Association Limited</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Duração =
do curso:=20
12 meses </P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Certificado de =
Analista de=20
Medidas de Tempos dos Métodos</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: Londres, em =
1974.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Francês=20
contemporâneo</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: =
Aliança Francesa=20
de Paris (França)</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Certificado de =
francês=20
4º grau da Aliança Francesa e Certificait de Français =
Pratique da Sorbonne em 1975</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: Paris =
(França).</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Medidas de Tempos =
&=20
Métodos (M.T.M - II)</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: SENAI</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Duração =
do curso:=20
quatro meses</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Certificado de =
Analista de Tempos=20
& Métodos - II</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: São =
Paulo, em=20
1978.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Programação=20
Cobol</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: Servimec</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Duração =
do curso:=20
oito meses</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: São =
Paulo, em=20
1982.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Organização &=20
Métodos</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: Datamec</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Duração =
do curso:=20
quatro meses, local: São Paulo, em 1985.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Curso de Dos, =
Windows, Word e=20
Excel</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: Data Sell</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Duração: 60 horas=20
em 1997</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: São =
Paulo.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Curso de =
Redação e=20
Atualização Gramatical</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: Verbum</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Duração: 2 meses em=20
09/10 de 1999</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: são =
Paulo.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Oficina de =
Tradução=20
e Versão</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Escola: Pontifica =
Universidade=20
Católica de São Paulo</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: =
justify">Duração: 2 meses,=20
em andamento.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify">Local: São =
Paulo.</P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><![if =
!supportEmptyParas]> <![endif]><O:P></O:P></P>
<P class=3DMsoNormal=20
style=3D"TEXT-ALIGN: justify"><B><U>Idiomas.<O:P></O:P></U></B></P>
<P class=3DMsoNormal style=3D"TEXT-ALIGN: justify"><B>Inglês, =
Francês,=20
Hebraico<O:P></O:P></B></P></DIV></BODY></HTML>
------=_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 <doc@freebsd.org>; 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 <doc@freebsd.org>; Thu, 27 Apr 2000 16:39:14 +0100 (WET DST)
Message-ID: <000801bfb056$939ed800$f6e632c1@univtroyes.fr>
From: "Koschinsky Stanislav" <stanislav.koschinsky@univ-troyes.fr>
To: <doc@freebsd.org>
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Dkoi8-r" http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Hello!</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>My name is Stanislav =
Koschinsky.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>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.)</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT> </DIV>
<DIV><FONT face=3DArial size=3D2>I think there should be something like=20
this:</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT> </DIV>
<DIV><FONT face=3DArial size=3D2>0x0 write/read Channel 0 =
starting/current=20
address</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x2 write/read Channel 1 =
starting/current=20
address</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x4 write/read Channel 2 =
starting/current=20
address</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x6 write/read Channel 3 =
starting/current=20
address</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x1 write/read Channel 0 =
starting/remaining=20
byte count</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x3 write/read Channel 1 =
starting/remaining=20
byte count</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x5 write/read Channel 2 =
starting/remaining=20
byte count</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x7 write/read Channel 3 =
starting/remaining=20
byte count</FONT></DIV>
<DIV> </DIV>
<DIV><FONT face=3DArial size=3D2>0x8 write/read command =
register</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>0x9 write request register</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>...</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>Please, verify the =
numbers.</FONT></DIV>
<DIV> </DIV>
<DIV> </DIV>
<DIV><FONT face=3DArial size=3D2>With best regards,</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>S.Koschinsky.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>e-mail: <A=20
href=3D"mailto:koschinsky@univ-troyes.fr">koschinsky@univ-troyes.fr</A></=
FONT></DIV>
<DIV> </DIV></BODY></HTML>
------=_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 <freebsd-doc@freebsd.org>; 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 <p_kuts@yahoo.com>
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 <freebsd-doc@FreeBSD.ORG>; 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 <screspi@gric.com>
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 <freebsd-doc@FreeBSD.ORG>; 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 <brooks@one-eyed-alien.net>
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 <freebsd-doc@FreeBSD.ORG>; 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 <andrews@technologist.com>
To: Brooks Davis <brooks@one-eyed-alien.net>
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 <andrews@technologist.com>
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 <doc@FreeBSD.org>; 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 <bill@2ez.com>
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" <paul@originative.co.uk>
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 <nik@freebsd.org>
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/<lang>/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 <nbm@mithrandr.moria.org>
To: "Paul Richards.width" <paul@originative.co.uk>
Cc: Nik Clayton <nik@freebsd.org>, 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" <paul@originative.co.uk>
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 <nbm@mithrandr.moria.org>
Cc: Nik Clayton <nik@freebsd.org>, 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 <nbm@mithrandr.moria.org>
To: "Paul Richards.width" <paul@originative.co.uk>
Cc: Nik Clayton <nik@freebsd.org>, 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 <phantom@cris.crimea.ua>
To: Neil Blakey-Milner <nbm@mithrandr.moria.org>
Cc: "Paul Richards.width" <paul@originative.co.uk>,
Nik Clayton <nik@FreeBSD.ORG>, 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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <freebsd-doc@freebsd.org>; 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 <freebsd-doc@freebsd.org>; 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 <jeffr@mhpcc.edu>
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 <freebsd-doc@FreeBSD.ORG>; 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 <phantom@cris.crimea.ua>
To: Jeff Ramacher <jeffr@mhpcc.edu>
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 <doc@FreeBSD.org>; 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 <doc@FreeBSD.org>; Fri, 28 Apr 2000 16:54:47 -0500 (CDT)
Reply-To: <carock@epctech.com>
From: "Chuck Rock" <carock@epctech.com>
To: <doc@FreeBSD.org>
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 <doc@FreeBSD.ORG>; 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 <jim@luna.cdrom.com>
To: Chuck Rock <carock@epctech.com>
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 <freebsd-doc@FreeBSD.org>; 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 <freebsd-doc@FreeBSD.org>; 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 <sunny@vstu.vinnica.ua>
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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <freebsd-doc@FreeBSD.ORG>; 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 <jruigrok@via-net-works.nl>
To: Mike Pritchard <mpp@mppsystems.com>
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
<jruigrok@via-net-works.nl> 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 <freebsd-doc@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <freebsd-doc@FreeBSD.org>; 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" <ron-asupervisor@intra.wish.net>
To: <freebsd-doc@FreeBSD.org>
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 <doc@freebsd.org>; 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 <david@mu.org>
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