From jhs@berklix.org  Fri Jan  4 10:17:52 2008
Return-Path: <jhs@berklix.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CDEE916A419
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  4 Jan 2008 10:17:52 +0000 (UTC)
	(envelope-from jhs@berklix.org)
Received: from tower.berklix.org (tower.berklix.org [83.236.223.114])
	by mx1.freebsd.org (Postfix) with ESMTP id BA6E813C455
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  4 Jan 2008 10:17:51 +0000 (UTC)
	(envelope-from jhs@berklix.org)
Received: from js.berklix.net (p549A6AE8.dip.t-dialin.net [84.154.106.232])
	(authenticated bits=0)
	by tower.berklix.org (8.13.6/8.13.6) with ESMTP id m04AHl4D099436
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 4 Jan 2008 10:17:49 GMT
	(envelope-from jhs@berklix.org)
Received: from laps.js.berklix.net (laps.js.berklix.net [192.168.91.56])
	by js.berklix.net (8.13.8/8.13.8) with ESMTP id m04AIQb4005636
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 4 Jan 2008 11:18:26 +0100 (CET)
	(envelope-from jhs@berklix.org)
Received: from laps.js.berklix.net (localhost.js.berklix.net [127.0.0.1])
	by laps.js.berklix.net (8.13.8/8.13.8) with ESMTP id m04AIQi4001672
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 4 Jan 2008 11:18:26 +0100 (CET)
	(envelope-from jhs@laps.js.berklix.net)
Received: (from jhs@localhost)
	by laps.js.berklix.net (8.13.8/8.13.8/Submit) id m04AIQcC001671;
	Fri, 4 Jan 2008 11:18:26 +0100 (CET)
	(envelope-from jhs)
Message-Id: <200801041018.m04AIQcC001671@laps.js.berklix.net>
Date: Fri, 4 Jan 2008 11:18:26 +0100 (CET)
From: Julian Stacey <jhs@berklix.org>
To: FreeBSD-gnats-submit@freebsd.org
Subject: Fix misleading man 1 split
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         119329
>Category:       docs
>Synopsis:       [patch] Fix misleading man 1 split
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jan 04 10:20:00 UTC 2008
>Closed-Date:    Tue Jun 14 22:41:24 UTC 2011
>Last-Modified:  Tue Jun 14 22:50:08 UTC 2011
>Originator:     Julian Stacey <jhs@berklix.com>
>Release:        FreeBSD 6.2-RELEASE i386
>Organization:
http://berklix.com
>Environment:
System: FreeBSD laps.js.berklix.net 6.2-RELEASE FreeBSD 6.2-RELEASE #0: Wed Dec 5 22:11:04 CET 2007 jhs@laps.js.berklix.net:/usr1/ftp/pri/FreeBSD/releases/i386/6.2-RELEASE/686/src/sys/i386/compile/LAPS.small i386


	
>Description:
	
The word "smaller" is misleading,
as on first reading, one assumes -b will create smaller than default size,
& only if one tries to specify eg -b 1000000 does one discover one can
get "smaller" files of 1000000 that are larger than the default of ~70K
(taking split /var/log/messages.0 as example)

>How-To-Repeat:
	
	man split

>Fix:

	

http://berklix.com/~jhs/src/bsd/fixes/freebsd/src/gen/usr.bin/split/split.1.REL=ALL.diff

*** FreeBSD-6.2-RELEASE/src/usr.bin/split/split.1.old	Fri Jan  4 10:58:52 2008
--- new-generic/src/usr.bin/split/split.1	Fri Jan  4 10:59:33 2008
***************
*** 66,72 ****
  .Ar suffix_length
  letters to form the suffix of the file name.
  .It Fl b
! Create smaller files
  .Ar byte_count
  bytes in length.
  If
--- 66,72 ----
  .Ar suffix_length
  letters to form the suffix of the file name.
  .It Fl b
! Create split files
  .Ar byte_count
  bytes in length.
  If
***************
*** 80,86 ****
  .Ar byte_count
  megabyte pieces.
  .It Fl l
! Create smaller files
  .Ar n
  lines in length.
  .It Fl p Ar pattern
--- 80,86 ----
  .Ar byte_count
  megabyte pieces.
  .It Fl l
! Create split files
  .Ar n
  lines in length.
  .It Fl p Ar pattern
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Fri Jan 4 11:18:06 UTC 2008 
Responsible-Changed-Why:  
Move this over to docs. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=119329 
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Sat Jan 24 05:33:04 UTC 2009 
State-Changed-Why:  
Patch applied along with a doc bump date, thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Sat Jan 24 05:33:04 UTC 2009 
Responsible-Changed-Why:  
Over to me. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/119329: commit references a PR
Date: Sat, 24 Jan 2009 05:32:26 +0000 (UTC)

 Author: trhodes
 Date: Sat Jan 24 05:32:11 2009
 New Revision: 187663
 URL: http://svn.freebsd.org/changeset/base/187663
 
 Log:
   When "-b" is specified, one could easily create "smaller" files
   that are much larger than expected (given the default size).
   Change "smaller files" to "split files" which is more in line
   with what "-b" actually does.
   
   PR:		119329
   Submitted by:	Julian Stacey <jhs@berklix.org>
 
 Modified:
   head/usr.bin/split/split.1
 
 Modified: head/usr.bin/split/split.1
 ==============================================================================
 --- head/usr.bin/split/split.1	Sat Jan 24 04:08:00 2009	(r187662)
 +++ head/usr.bin/split/split.1	Sat Jan 24 05:32:11 2009	(r187663)
 @@ -32,7 +32,7 @@
  .\"	@(#)split.1	8.3 (Berkeley) 4/16/94
  .\" $FreeBSD$
  .\"
 -.Dd March 16, 2008
 +.Dd January 23, 2009
  .Dt SPLIT 1
  .Os
  .Sh NAME
 @@ -88,7 +88,7 @@ letters to form the suffix of the file n
  .Cm K | k | M | m | G | g
  .Sm on
  .Oc
 -Create smaller files
 +Create split files
  .Ar byte_count
  bytes in length.
  If
 @@ -113,7 +113,7 @@ is appended to the number, the file is s
  .Ar byte_count
  gigabyte pieces.
  .It Fl l Ar line_count
 -Create smaller files
 +Create split files
  .Ar line_count
  lines in length.
  .It Fl n Ar chunk_count
 _______________________________________________
 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"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Tue Jun 14 22:41:11 UTC 2011 
State-Changed-Why:  
MFCd to stable/7. 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/119329: commit references a PR
Date: Tue, 14 Jun 2011 22:40:28 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Tue Jun 14 22:40:13 2011
 New Revision: 223101
 URL: http://svn.freebsd.org/changeset/base/223101
 
 Log:
   MFC 187663 by trhodes:
   
   When "-b" is specified, one could easily create "smaller" files
   that are much larger than expected (given the default size).
   Change "smaller files" to "split files" which is more in line
   with what "-b" actually does.
   
   PR:		119329
 
 Modified:
   stable/7/usr.bin/split/split.1
 Directory Properties:
   stable/7/usr.bin/split/   (props changed)
 
 Modified: stable/7/usr.bin/split/split.1
 ==============================================================================
 --- stable/7/usr.bin/split/split.1	Tue Jun 14 22:37:09 2011	(r223100)
 +++ stable/7/usr.bin/split/split.1	Tue Jun 14 22:40:13 2011	(r223101)
 @@ -32,7 +32,7 @@
  .\"	@(#)split.1	8.3 (Berkeley) 4/16/94
  .\" $FreeBSD$
  .\"
 -.Dd August 10, 2006
 +.Dd January 23, 2009
  .Dt SPLIT 1
  .Os
  .Sh NAME
 @@ -84,7 +84,7 @@ letters to form the suffix of the file n
  .Cm K | k | M | m | G | g
  .Sm on
  .Oc
 -Create smaller files
 +Create split files
  .Ar byte_count
  bytes in length.
  If
 @@ -109,7 +109,7 @@ is appended to the number, the file is s
  .Ar byte_count
  gigabyte pieces.
  .It Fl l Ar line_count
 -Create smaller files
 +Create split files
  .Ar line_count
  lines in length.
  .It Fl p Ar pattern
 _______________________________________________
 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"
 
>Unformatted:
