From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.2 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 14512 invoked from network); 2 Nov 2021 19:47:18 -0000 Received: from 4ess.inri.net (216.126.196.42) by inbox.vuxu.org with ESMTPUTF8; 2 Nov 2021 19:47:18 -0000 Received: from mail-pl1-f178.google.com ([209.85.214.178]) by 4ess; Tue Nov 2 13:14:39 -0400 2021 Received: by mail-pl1-f178.google.com with SMTP id y1so17304210plk.10 for <9front@9front.org>; Tue, 02 Nov 2021 10:14:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=date:from:to:subject:message-id:mime-version:content-disposition; bh=IPYT3s1QB67GBzBQbduXOq+685qYNS8LAkajTnYQA6A=; b=FJgd2ymMvMx0hzOtUimryiZnbno08JCIt3FIZoVYNYI/mVifMpOLotZFDLd7v9/Hyx nBs8O0E5ZPT6BVF92TO5GA4ROH9fUB9uk0PTFnF9G0QWaUv9i8AFPbSkAp+mLfVKx/eS Nubq1LsCRDGwU/VQYqJhnT7qFConl3J8otDSf1d9K5Cz/w95qVUO9nSFo41k1i+EnEvE Mt61cOSPyMkHzKyqFGTcko2Rdvf04/nragcM2VPPQaM5WQDtE9hb5leWpNsugHtTf+Rr drd2ZuT2U3XgdrkTFjtDS6REHWnzqkg2OE53UdCnLi+UGRyIgLUY0cBebidgx03Dtp2P tsDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:subject:message-id:mime-version :content-disposition; bh=IPYT3s1QB67GBzBQbduXOq+685qYNS8LAkajTnYQA6A=; b=NnkYCmrXTftL01LUWYAklULrPdqrSAu5I7foQqE+y8mXy6/dBGMhE471mY3dTcs4J2 Z50t3vaOiSCAdVbppLuljRlTMfVhxBTDuczfkWzDA1cxnJBg33qnGqgC/zzEozdoEAWk fbUB7UAPsg0S+stbnsj+FnVRVMawqI0530qDh2hAV2o2R6FgW5qzBSf6LMOEZsalXbns I3pwVsmaCay5GYiLDYhdW2Z4iCeDqscB9xFQYO4lL91dSxs2ZQGeyhM7mLKTcVxQixwg w8WBXAEYqW8WAZn2cZNyUZhPDgqxinNOFz2YhinZkDIwtZ+JMjjTEQMeepPfkcW2I7Uc PzHQ== X-Gm-Message-State: AOAM531Fh1/oYaAuS2JPi6SP6yHpRnIh7peP+daJUKPbHJjOFhfeptbI GJsrnOPduxKQShch38oVh+D0dSzmxsE= X-Google-Smtp-Source: ABdhPJx5Lk36YbXE3zGA+QR77/pA/t6ICN0SVcEJDRAS7APv5VRzC92VDEfR3Gbo6Ab328x25LWvdQ== X-Received: by 2002:a17:90b:3d3:: with SMTP id go19mr8012541pjb.23.1635873271682; Tue, 02 Nov 2021 10:14:31 -0700 (PDT) Return-Path: Received: from imac.0x30.net (d205-250-121-157.bchsia.telus.net. [205.250.121.157]) by smtp.gmail.com with ESMTPSA id 145sm11875504pfx.87.2021.11.02.10.14.30 for <9front@9front.org> (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Tue, 02 Nov 2021 10:14:30 -0700 (PDT) Date: Tue, 2 Nov 2021 10:14:28 -0700 From: Kyle Milz To: 9front@9front.org Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline; filename="man_du_args_table.diff" List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: pipelining realtime-based rails reduce/map-aware browser markup Subject: [9front] man du args table diff Reply-To: 9front@9front.org Precedence: bulk hi, i think it is clearer when argument descriptions are listed in table form vs paragraph form. diff below converts most of du's arguments to a table. -b is still hanging out in the first paragraph, i'll get to that if this diff is ok. i left the -s description as is, its not great but not incorrect either. the only semantic description change intended is -n 'it sets' to 'this implies'. kyle diff ca73f673473457152d6f1b2e9030495f8dec5c49 uncommitted --- a/sys/man/1/du +++ b/sys/man/1/du @@ -35,24 +35,22 @@ The count for a directory includes the counts of the contained files and directories. .PP -The +The options are: +.TP .B -a -option prints the number of blocks +Print the number of blocks for every file in a directory. Normally counts are printed only for contained directories. -.PP -The +.TP .B -f -option suppresses the printing of warning messages. -.PP -The +Suppress the printing of warning messages. +.TP .B -n -option prints the size in bytes and the name of each file; it sets +Print the size in bytes and the name of each file; this implies .BR -a . -.PP -The +.TP .B -t -option prints, in the format of +Print, in the format of .B du .BR -n , the modified time of @@ -60,48 +58,34 @@ If the options .B -tu are specified then the accessed time is printed. -.PP -The +.TP .B -q -option prints, in the format of +Print, in the format of .B du .BR -n , the QID path of each file rather than the size. -.PP -The +.TP .B -s -option causes -.I du -to descend the hierarchy as always, but to print only a summary line -for each +Descend the hierarchy as always, but print only a summary line for each .IR file . -.PP -The +.TP .B -e -option causes -.I du -to print values (sizes, times or QID paths) +Print values (sizes, times or QID paths) in `scientific notation' via .IR print (2)'s .BR %g . -.PP -The +.TP .B -h -option causes -.I du -to print values (sizes, times or QID paths) +Print values (sizes, times or QID paths) in scientific notation, scaled to less than 1024, and with a suitable SI prefix (e.g., .L G for binary gigabytes). -.PP -The +.TP .B -p -option causes -.I du -to print values (sizes, times or QID paths) +Print values (sizes, times or QID paths) in units of .IR SI-prefix . Case is ignored when looking up