From owner-freebsd-doc Mon Dec 31 6:10:13 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 16CE337B433 for ; Mon, 31 Dec 2001 06:10:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fBVEA1B03946; Mon, 31 Dec 2001 06:10:01 -0800 (PST) (envelope-from gnats) Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200]) by hub.freebsd.org (Postfix) with ESMTP id 34C9437B429 for ; Mon, 31 Dec 2001 06:00:32 -0800 (PST) Received: from pc3-card4-0-cust122.cdf.cable.ntl.com ([62.254.251.122] helo=rhadamanth.private.submonkey.net ident=exim) by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2) id 16L2zO-0002Zs-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 31 Dec 2001 14:00:30 +0000 Received: from setantae by rhadamanth.private.submonkey.net with local (Exim 3.33 #1) id 16L2zM-0001us-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 31 Dec 2001 14:00:28 +0000 Message-Id: Date: Mon, 31 Dec 2001 14:00:28 +0000 From: Ceri Reply-To: Ceri To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/33390: Markup fix for tuning.7 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 33390 >Category: docs >Synopsis: Markup fix for tuning.7 >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: Mon Dec 31 06:10:00 PST 2001 >Closed-Date: >Last-Modified: >Originator: Ceri >Release: FreeBSD 4.5-PRERELEASE i386 >Organization: >Environment: System: FreeBSD rhadamanth.private.submonkey.net 4.5-PRERELEASE FreeBSD 4.5-PRERELEASE #3: Wed Dec 26 18:27:46 GMT 2001 root@rhadamanth.private.submonkey.net:/usr/obj/usr/src/sys/RHADAMANTH i386 >Description: tuning.7 contains two strange pieces of markup regarding /var/tmp. I can see why it's been done, since the author clearly wishes to refer to /tmp and/or /var/tmp, but it looks horrific : [/var]/tmp Since the manual page has already suggested symlinking /tmp -> /var/tmp, it might be best to lose the brackets altogether. Another option could be to just say "temporary directories". My suggested patch is below, but if it's decided that this is ok as is, so be it. Ceri >How-To-Repeat: man tuning >Fix: *** src/share/man/man7/tuning.7.old Mon Dec 31 13:50:09 2001 --- src/share/man/man7/tuning.7 Mon Dec 31 13:51:08 2001 *************** *** 90,100 **** two reasons: first, it reduces the possibility of filesystem corruption in a crash, and second it reduces the chance of a runaway process that fills up ! .Oo Pa /var Oc Ns Pa /tmp from blowing up more critical subsystems (mail, logging, etc). Filling up ! .Oo Pa /var Oc Ns Pa /tmp is a very common problem to have. .Pp In the old days there were differences between --- 90,100 ---- two reasons: first, it reduces the possibility of filesystem corruption in a crash, and second it reduces the chance of a runaway process that fills up ! .Pa /var/tmp from blowing up more critical subsystems (mail, logging, etc). Filling up ! .Pa /var/tmp is a very common problem to have. .Pp In the old days there were differences between >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message