[prev in list] [next in list] [prev in thread] [next in thread] 

List:       freebsd-doc
Subject:    docs/33390: Markup fix for tuning.7
From:       Ceri <setantae () submonkey ! net>
Date:       2001-12-31 14:00:28
[Download RAW message or body]


> 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 <setantae@submonkey.net>
> 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


[prev in list] [next in list] [prev in thread] [next in thread]