Skip to content

Commit ecc6399

Browse files
committed
deploy: 2ed80ff
1 parent 10acc51 commit ecc6399

File tree

6 files changed

+49
-27
lines changed

6 files changed

+49
-27
lines changed

user/extensions.html

+2
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,8 @@ <h2 id="more"><a class="header" href="#more"><code>more</code></a></h2>
190190
coreutils. We do not aim for full compatibility with the <code>more</code> utility from
191191
<code>util-linux</code>. Features from more modern pagers (like <code>less</code> and <code>bat</code>) are
192192
therefore welcomed.</p>
193+
<h2 id="cut"><a class="header" href="#cut"><code>cut</code></a></h2>
194+
<p><code>cut</code> can separate fields by whitespace (Space and Tab) with <code>-w</code> flag. This feature is adopted from <a href="https://www.freebsd.org/cgi/man.cgi?cut">FreeBSD</a>.</p>
193195

194196
</main>
195197

user/print.html

+24-13
Original file line numberDiff line numberDiff line change
@@ -638,6 +638,8 @@ <h2 id="more"><a class="header" href="#more"><code>more</code></a></h2>
638638
coreutils. We do not aim for full compatibility with the <code>more</code> utility from
639639
<code>util-linux</code>. Features from more modern pagers (like <code>less</code> and <code>bat</code>) are
640640
therefore welcomed.</p>
641+
<h2 id="cut"><a class="header" href="#cut"><code>cut</code></a></h2>
642+
<p><code>cut</code> can separate fields by whitespace (Space and Tab) with <code>-w</code> flag. This feature is adopted from <a href="https://www.freebsd.org/cgi/man.cgi?cut">FreeBSD</a>.</p>
641643
<div style="break-before: page; page-break-before: always;"></div><h1 id="multi-call-binary"><a class="header" href="#multi-call-binary">Multi-call binary</a></h1>
642644
<p>uutils includes a multi-call binary from which the utils can be invoked. This
643645
reduces the binary size of the binary and can be useful for portability.</p>
@@ -1945,7 +1947,7 @@ <h2 id="examples-14"><a class="header" href="#examples-14">Examples</a></h2>
19451947
<p>The examples are provided by the <a href="https://tldr.sh">tldr-pages project</a> under the <a href="https://github.com/tldr-pages/tldr/blob/main/LICENSE.md">CC BY 4.0 License</a>.</p>
19461948
<p>Please note that, as uutils is a work in progress, some examples might fail.</p>
19471949
</blockquote>
1948-
<div style="break-before: page; page-break-before: always;"></div><h1 id="cut"><a class="header" href="#cut">cut</a></h1>
1950+
<div style="break-before: page; page-break-before: always;"></div><h1 id="cut-1"><a class="header" href="#cut-1">cut</a></h1>
19491951
<div class="additional">
19501952
<div class="platforms">
19511953
<i class="fa fa-brands fa-linux"></i>
@@ -1955,7 +1957,7 @@ <h2 id="examples-14"><a class="header" href="#examples-14">Examples</a></h2>
19551957
<div class="version">v0.0.16
19561958
</div>
19571959
</div>
1958-
<pre><code>cut [-d] [-s] [-z] [--output-delimiter] ((-f|-b|-c) {{sequence}}) {{sourcefile}}+
1960+
<pre><code>cut [-d|-w] [-s] [-z] [--output-delimiter] ((-f|-b|-c) {{sequence}}) {{sourcefile}}+
19591961
</code></pre>
19601962
<p>Prints specified byte or field columns from each line of stdin or the input files</p>
19611963
<h2 id="options-17"><a class="header" href="#options-17">Options</a></h2>
@@ -1971,6 +1973,10 @@ <h2 id="options-17"><a class="header" href="#options-17">Options</a></h2>
19711973
<dd>
19721974
<p>specify the delimiter character that separates fields in the input source. Defaults to Tab.</p>
19731975
</dd>
1976+
<dt><code>-w &lt;WHITESPACE&gt;</code></dt>
1977+
<dd>
1978+
<p>Use any number of whitespace (Space, Tab) to separate fields in the input source (FreeBSD extension).</p>
1979+
</dd>
19741980
<dt><code>--fields=&lt;LIST&gt;</code>, <code>-f &lt;LIST&gt;</code></dt>
19751981
<dd>
19761982
<p>filter field columns from the input source</p>
@@ -2056,6 +2062,11 @@ <h2 id="options-17"><a class="header" href="#options-17">Options</a></h2>
20562062
--delimiter (-d) option. Setting the delimiter is optional.
20572063
If not set, a default delimiter of Tab will be used.
20582064

2065+
If the -w option is provided, fields will be separated by any number
2066+
of whitespace characters (Space and Tab). The output delimiter will
2067+
be a Tab unless explicitly specified. Only one of -d or -w option can be specified.
2068+
This is an extension adopted from FreeBSD.
2069+
20592070
Optionally Filter based on delimiter
20602071
If the --only-delimited (-s) flag is provided, only lines which
20612072
contain the delimiter will be printed
@@ -2318,25 +2329,25 @@ <h2 id="options-19"><a class="header" href="#options-19">Options</a></h2>
23182329
nofollow do not follow system links.
23192330
</code></pre>
23202331
<h2 id="examples-17"><a class="header" href="#examples-17">Examples</a></h2>
2321-
<p>Make a bootable USB drive from an isohybrid file (such like <code>archlinux-xxx.iso</code>) and show the progress:</p>
2322-
<pre><code class="language-shell">dd if={{file.iso}} of=/dev/{{usb_drive}} status=progress
2332+
<p>Make a bootable USB drive from an isohybrid file (such like <code>archlinux-xxx.iso</code>):</p>
2333+
<pre><code class="language-shell">dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}
23232334
</code></pre>
2324-
<p>Clone a drive to another drive with 4 MiB block, ignore error and show progress:</p>
2325-
<pre><code class="language-shell">dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs=4M conv=noerror status=progress
2335+
<p>Clone a drive to another drive with 4 MiB block and ignore error:</p>
2336+
<pre><code class="language-shell">dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs={{4194304}} conv={{noerror}}
23262337
</code></pre>
23272338
<p>Generate a file of 100 random bytes by using kernel random driver:</p>
2328-
<pre><code class="language-shell">dd if=/dev/urandom of={{random_file}} bs=100 count=1
2339+
<pre><code class="language-shell">dd if=/dev/urandom of={{path/to/random_file}} bs={{100}} count={{1}}
23292340
</code></pre>
23302341
<p>Benchmark the write performance of a disk:</p>
2331-
<pre><code class="language-shell">dd if=/dev/zero of={{file_1GB}} bs=1024 count=1000000
2342+
<pre><code class="language-shell">dd if=/dev/zero of={{path/to/file_1GB}} bs={{1024}} count={{1000000}}
23322343
</code></pre>
2333-
<p>Generate a system backup into an IMG file and show the progress:</p>
2334-
<pre><code class="language-shell">dd if=/dev/{{drive_device}} of={{path/to/file.img}} status=progress
2344+
<p>Generate a system backup into an IMG file:</p>
2345+
<pre><code class="language-shell">dd if={{/dev/drive_device}} of={{path/to/file.img}}
23352346
</code></pre>
2336-
<p>Restore a drive from an IMG file and show the progress:</p>
2337-
<pre><code class="language-shell">dd if={{path/to/file.img}} of=/dev/{{drive_device}} status=progress
2347+
<p>Restore a drive from an IMG file:</p>
2348+
<pre><code class="language-shell">dd if={{path/to/file.img}} of={{/dev/drive_device}}
23382349
</code></pre>
2339-
<p>Check progress of an ongoing dd operation (Run this command from another shell):</p>
2350+
<p>Check the progress of an ongoing dd operation (run this command from another shell):</p>
23402351
<pre><code class="language-shell">kill -USR1 $(pgrep ^dd)
23412352
</code></pre>
23422353
<blockquote>

user/searchindex.js

+1-1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

user/searchindex.json

+1-1
Large diffs are not rendered by default.

user/utils/cut.html

+10-1
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ <h1 id="cut"><a class="header" href="#cut">cut</a></h1>
176176
<div class="version">v0.0.16
177177
</div>
178178
</div>
179-
<pre><code>cut [-d] [-s] [-z] [--output-delimiter] ((-f|-b|-c) {{sequence}}) {{sourcefile}}+
179+
<pre><code>cut [-d|-w] [-s] [-z] [--output-delimiter] ((-f|-b|-c) {{sequence}}) {{sourcefile}}+
180180
</code></pre>
181181
<p>Prints specified byte or field columns from each line of stdin or the input files</p>
182182
<h2 id="options"><a class="header" href="#options">Options</a></h2>
@@ -192,6 +192,10 @@ <h2 id="options"><a class="header" href="#options">Options</a></h2>
192192
<dd>
193193
<p>specify the delimiter character that separates fields in the input source. Defaults to Tab.</p>
194194
</dd>
195+
<dt><code>-w &lt;WHITESPACE&gt;</code></dt>
196+
<dd>
197+
<p>Use any number of whitespace (Space, Tab) to separate fields in the input source (FreeBSD extension).</p>
198+
</dd>
195199
<dt><code>--fields=&lt;LIST&gt;</code>, <code>-f &lt;LIST&gt;</code></dt>
196200
<dd>
197201
<p>filter field columns from the input source</p>
@@ -277,6 +281,11 @@ <h2 id="options"><a class="header" href="#options">Options</a></h2>
277281
--delimiter (-d) option. Setting the delimiter is optional.
278282
If not set, a default delimiter of Tab will be used.
279283

284+
If the -w option is provided, fields will be separated by any number
285+
of whitespace characters (Space and Tab). The output delimiter will
286+
be a Tab unless explicitly specified. Only one of -d or -w option can be specified.
287+
This is an extension adopted from FreeBSD.
288+
280289
Optionally Filter based on delimiter
281290
If the --only-delimited (-s) flag is provided, only lines which
282291
contain the delimiter will be printed

user/utils/dd.html

+11-11
Original file line numberDiff line numberDiff line change
@@ -303,25 +303,25 @@ <h2 id="options"><a class="header" href="#options">Options</a></h2>
303303
nofollow do not follow system links.
304304
</code></pre>
305305
<h2 id="examples"><a class="header" href="#examples">Examples</a></h2>
306-
<p>Make a bootable USB drive from an isohybrid file (such like <code>archlinux-xxx.iso</code>) and show the progress:</p>
307-
<pre><code class="language-shell">dd if={{file.iso}} of=/dev/{{usb_drive}} status=progress
306+
<p>Make a bootable USB drive from an isohybrid file (such like <code>archlinux-xxx.iso</code>):</p>
307+
<pre><code class="language-shell">dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}
308308
</code></pre>
309-
<p>Clone a drive to another drive with 4 MiB block, ignore error and show progress:</p>
310-
<pre><code class="language-shell">dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs=4M conv=noerror status=progress
309+
<p>Clone a drive to another drive with 4 MiB block and ignore error:</p>
310+
<pre><code class="language-shell">dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs={{4194304}} conv={{noerror}}
311311
</code></pre>
312312
<p>Generate a file of 100 random bytes by using kernel random driver:</p>
313-
<pre><code class="language-shell">dd if=/dev/urandom of={{random_file}} bs=100 count=1
313+
<pre><code class="language-shell">dd if=/dev/urandom of={{path/to/random_file}} bs={{100}} count={{1}}
314314
</code></pre>
315315
<p>Benchmark the write performance of a disk:</p>
316-
<pre><code class="language-shell">dd if=/dev/zero of={{file_1GB}} bs=1024 count=1000000
316+
<pre><code class="language-shell">dd if=/dev/zero of={{path/to/file_1GB}} bs={{1024}} count={{1000000}}
317317
</code></pre>
318-
<p>Generate a system backup into an IMG file and show the progress:</p>
319-
<pre><code class="language-shell">dd if=/dev/{{drive_device}} of={{path/to/file.img}} status=progress
318+
<p>Generate a system backup into an IMG file:</p>
319+
<pre><code class="language-shell">dd if={{/dev/drive_device}} of={{path/to/file.img}}
320320
</code></pre>
321-
<p>Restore a drive from an IMG file and show the progress:</p>
322-
<pre><code class="language-shell">dd if={{path/to/file.img}} of=/dev/{{drive_device}} status=progress
321+
<p>Restore a drive from an IMG file:</p>
322+
<pre><code class="language-shell">dd if={{path/to/file.img}} of={{/dev/drive_device}}
323323
</code></pre>
324-
<p>Check progress of an ongoing dd operation (Run this command from another shell):</p>
324+
<p>Check the progress of an ongoing dd operation (run this command from another shell):</p>
325325
<pre><code class="language-shell">kill -USR1 $(pgrep ^dd)
326326
</code></pre>
327327
<blockquote>

0 commit comments

Comments
 (0)