Bug 169487

Summary: Files mentioned in build(7) do not exist
Product: Documentation Reporter: Moritz Wilhelmy <mw>
Component: Books & ArticlesAssignee: Warren Block <wblock>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Moritz Wilhelmy 2012-06-27 15:20:06 UTC
	The following files are mentioned in the build(7) manpage on top of the
	FILES section:

	/usr/doc/Makefile
	/usr/doc/share/mk/doc.project.mk

	However, they do not exist. In fact, I could not find a file called anything
    like doc.project.mk on the entire system.
    I therefore assume that the information is outdated.

How-To-Repeat: 	Search for FILES in build(7)
Comment 1 Warren Block freebsd_committer freebsd_triage 2012-06-27 17:46:06 UTC
Responsible Changed
From-To: freebsd-doc->wblock

Take.
Comment 2 dfilter service freebsd_committer freebsd_triage 2012-06-27 18:51:24 UTC
Author: wblock (doc committer)
Date: Wed Jun 27 17:51:09 2012
New Revision: 237655
URL: http://svn.freebsd.org/changeset/base/237655

Log:
  Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
  exist until populated with csup(1) or svn(1).
  
  PR:		169487
  Submitted by:	Moritz Wilhelmy
  MFC after:	1 day

Modified:
  head/share/man/man7/build.7

Modified: head/share/man/man7/build.7
==============================================================================
--- head/share/man/man7/build.7	Wed Jun 27 16:46:02 2012	(r237654)
+++ head/share/man/man7/build.7	Wed Jun 27 17:51:09 2012	(r237655)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 29, 2011
+.Dd June 27, 2012
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -39,6 +39,10 @@ normally
 .Pa /usr/doc ,
 and
 .Pa /usr/ports .
+These directories may be initially empty or non-existent until updated with
+.Xr csup 1
+or
+.Xr svn 1 .
 Directory
 .Pa /usr/src
 contains the
@@ -489,7 +493,7 @@ on built objects.
 .It Va NO_SHARE
 If set, the build does not descend into the
 .Pa /usr/src/share
-subdirectory (i.e. manpages, locale data files, timezone data files and
+subdirectory (i.e., manpages, locale data files, timezone data files and
 other
 .Pa /usr/src/share
 files will not be rebuild from their sources).
@@ -594,8 +598,10 @@ make TARGET=sparc64 DESTDIR=/clients/spa
 .Ed
 .Sh SEE ALSO
 .Xr cc 1 ,
+.Xr csup 1 ,
 .Xr install 1 ,
 .Xr make 1 ,
+.Xr svn 1 ,
 .Xr make.conf 5 ,
 .Xr src.conf 5 ,
 .Xr ports r7 ,
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 3 Warren Block freebsd_committer freebsd_triage 2012-06-27 19:05:06 UTC
State Changed
From-To: open->closed

Update committed to share/man/man7/build.7.  Thanks!
Comment 4 dfilter service freebsd_committer freebsd_triage 2012-06-28 14:10:48 UTC
Author: wblock (doc committer)
Date: Thu Jun 28 13:10:36 2012
New Revision: 237708
URL: http://svn.freebsd.org/changeset/base/237708

Log:
  MFC r237655:
  
  Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
  exist until populated with csup(1) or svn(1).
  
  PR:		169487
  Submitted by:	Moritz Wilhelmy

Modified:
  stable/9/share/man/man7/build.7
Directory Properties:
  stable/9/share/man/man7/   (props changed)

Modified: stable/9/share/man/man7/build.7
==============================================================================
--- stable/9/share/man/man7/build.7	Thu Jun 28 13:05:56 2012	(r237707)
+++ stable/9/share/man/man7/build.7	Thu Jun 28 13:10:36 2012	(r237708)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 29, 2011
+.Dd June 27, 2012
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -39,6 +39,10 @@ normally
 .Pa /usr/doc ,
 and
 .Pa /usr/ports .
+These directories may be initially empty or non-existent until updated with
+.Xr csup 1
+or
+.Xr svn 1 .
 Directory
 .Pa /usr/src
 contains the
@@ -489,7 +493,7 @@ on built objects.
 .It Va NO_SHARE
 If set, the build does not descend into the
 .Pa /usr/src/share
-subdirectory (i.e. manpages, locale data files, timezone data files and
+subdirectory (i.e., manpages, locale data files, timezone data files and
 other
 .Pa /usr/src/share
 files will not be rebuild from their sources).
@@ -594,8 +598,10 @@ make TARGET=sparc64 DESTDIR=/clients/spa
 .Ed
 .Sh SEE ALSO
 .Xr cc 1 ,
+.Xr csup 1 ,
 .Xr install 1 ,
 .Xr make 1 ,
+.Xr svn 1 ,
 .Xr make.conf 5 ,
 .Xr src.conf 5 ,
 .Xr ports r7 ,
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 5 dfilter service freebsd_committer freebsd_triage 2012-06-28 14:11:54 UTC
Author: wblock (doc committer)
Date: Thu Jun 28 13:11:34 2012
New Revision: 237709
URL: http://svn.freebsd.org/changeset/base/237709

Log:
  MFC r237655:
  
  Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
  exist until populated with csup(1) or svn(1).
  
  PR:		169487
  Submitted by:	Moritz Wilhelmy

Modified:
  stable/8/share/man/man7/build.7
Directory Properties:
  stable/8/share/man/man7/   (props changed)

Modified: stable/8/share/man/man7/build.7
==============================================================================
--- stable/8/share/man/man7/build.7	Thu Jun 28 13:10:36 2012	(r237708)
+++ stable/8/share/man/man7/build.7	Thu Jun 28 13:11:34 2012	(r237709)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 29, 2011
+.Dd June 27, 2012
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -39,6 +39,10 @@ normally
 .Pa /usr/doc ,
 and
 .Pa /usr/ports .
+These directories may be initially empty or non-existent until updated with
+.Xr csup 1
+or
+.Xr svn 1 .
 Directory
 .Pa /usr/src
 contains the
@@ -455,7 +459,7 @@ on built objects.
 .It Va NO_SHARE
 If set, the build does not descend into the
 .Pa /usr/src/share
-subdirectory (i.e. manpages, locale data files, timezone data files and
+subdirectory (i.e., manpages, locale data files, timezone data files and
 other
 .Pa /usr/src/share
 files will not be rebuild from their sources).
@@ -556,8 +560,10 @@ make TARGET=sparc64 DESTDIR=/clients/spa
 .Ed
 .Sh SEE ALSO
 .Xr cc 1 ,
+.Xr csup 1 ,
 .Xr install 1 ,
 .Xr make 1 ,
+.Xr svn 1 ,
 .Xr make.conf 5 ,
 .Xr src.conf 5 ,
 .Xr ports r7 ,
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 6 dfilter service freebsd_committer freebsd_triage 2012-06-28 14:12:44 UTC
Author: wblock (doc committer)
Date: Thu Jun 28 13:12:34 2012
New Revision: 237710
URL: http://svn.freebsd.org/changeset/base/237710

Log:
  MFC r237655:
  
  Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
  exist until populated with csup(1) or svn(1).
  
  PR:		169487
  Submitted by:	Moritz Wilhelmy

Modified:
  stable/7/share/man/man7/build.7
Directory Properties:
  stable/7/share/man/man7/   (props changed)

Modified: stable/7/share/man/man7/build.7
==============================================================================
--- stable/7/share/man/man7/build.7	Thu Jun 28 13:11:34 2012	(r237709)
+++ stable/7/share/man/man7/build.7	Thu Jun 28 13:12:34 2012	(r237710)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 29, 2011
+.Dd June 27, 2012
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -39,6 +39,10 @@ normally
 .Pa /usr/doc ,
 and
 .Pa /usr/ports .
+These directories may be initially empty or non-existent until updated with
+.Xr csup 1
+or
+.Xr svn 1 .
 Directory
 .Pa /usr/src
 contains the
@@ -422,7 +426,7 @@ on built objects.
 .It Va NO_SHARE
 If set, the build does not descend into the
 .Pa /usr/src/share
-subdirectory (i.e. manpages, locale data files, timezone data files and
+subdirectory (i.e., manpages, locale data files, timezone data files and
 other
 .Pa /usr/src/share
 files will not be rebuild from their sources).
@@ -494,8 +498,10 @@ make TARGET_ARCH=sparc64 DESTDIR=/client
 .Ed
 .Sh SEE ALSO
 .Xr cc 1 ,
+.Xr csup 1 ,
 .Xr install 1 ,
 .Xr make 1 ,
+.Xr svn 1 ,
 .Xr make.conf 5 ,
 .Xr src.conf 5 ,
 .Xr ports r7 ,
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"