From swear@blarg.net  Thu Mar  7 14:26:48 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 920F337B404
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 14:26:33 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id E776CBC7E
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 14:26:31 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id OAA24521
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 7 Mar 2002 14:26:29 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g27MTg546785;
	Thu, 7 Mar 2002 14:29:42 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <rsu1rsau5m.1rs@localhost.localdomain>
Date: 07 Mar 2002 14:29:41 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: bsd.README seriously obsolete
X-GNATS-Notify:

>Number:         35652
>Category:       docs
>Synopsis:       bsd.README seriously obsolete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 07 14:30:01 PST 2002
>Closed-Date:    
>Last-Modified:  Fri May 30 22:10:00 UTC 2014
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

From "/usr/share/mk/bsd.README":
    XXX This document is seriously out of date, it is currenly being
    revised.

But there is no indication of who is revising it and I find no PR for
it.

================
>How-To-Repeat:
n/a
================
>Fix:

-- Most of the file's (long-form) descriptions should probably be moved
into the files which are described.

-- Determine which (long-form) descriptions are missing and add them.

-- Add these missing entries to the list of similar entries:

bsd.cpu.mk              - sets CPU/arch-related variables
bsd.docb.mk             - handles installing SGML/docbook documents
bsd.port.post.mk        - building ports [tbd: needs more info]
bsd.port.pre.mk         - building ports [tbd: needs more info]
bsd.sys.mk              - common settings used for building FreeBSD sources
sys.mk                  - default rules for all makes
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Jul 16 08:01:07 PDT 2002 
State-Changed-Why:  
ru has just done a nice cleapup of these files, and removed the docb.mk along 
with sgml.mk 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35652 
State-Changed-From-To: closed->open 
State-Changed-By: tom 
State-Changed-When: Fri Jan 24 08:23:50 PST 2003 
State-Changed-Why:  
The document (/usr/share/mk/bsd.README) still describes itself as 
"seriously out of date". 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35652 
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue May 6 17:42:08 PDT 2003 
Responsible-Changed-Why:  
I'll work on this too. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35652 

From: Sevan Janiyan <venture37@geeklan.co.uk>
To: bug-followup@FreeBSD.org, swear@blarg.net
Cc:  
Subject: Re: docs/35652: bsd.README seriously obsolete
Date: Fri, 30 May 2014 23:04:58 +0100

 Aside from point one, "Most of the file's (long-form) descriptions 
 should probably be moved into the files which are described."
 Everything was cleared up at r115103 right?
>Unformatted:
