pages*: improve page descriptions (#12558)

* pages*: improve page descriptions

* ical: improve page description

* cockpit-desktop: remove unneeded word from page description

* nc: improve description wording

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

pages/android/dumpsys.md

@@ -1,6 +1,6 @@
 # dumpsys
 
-> Provide information about Android system services.
+> Get information about Android system services.
 > This command can only be used through `adb shell`.
 > More information: <https://developer.android.com/tools/dumpsys>.
 

pages/common/ajson.md

@@ -1,6 +1,6 @@
 # ajson
 
-> Executes JSONPath on JSON objects.
+> Execute JSONPath on JSON objects.
 > More information: <https://github.com/spyzhov/ajson>.
 
 - Read JSON from a file and execute a specified JSONPath expression:

pages/common/ansible-vault.md

@@ -1,6 +1,6 @@
 # ansible-vault
 
-> Encrypts & decrypts values, data structures and files within Ansible projects.
+> Encrypt and decrypt values, data structures and files within Ansible projects.
 > More information: <https://docs.ansible.com/ansible/latest/user_guide/vault.html#id17>.
 
 - Create a new encrypted vault file with a prompt for a password:

pages/common/anytopnm.md

@@ -1,6 +1,6 @@
 # anytopnm
 
-> Converts an arbitrary type of image file to common image formats.
+> Convert an arbitrary type of image file to common image formats.
 > More information: <https://netpbm.sourceforge.net/doc/anytopnm.html>.
 
 - Convert an input image to PBM, PGM, or PPM format irrespective of the input type:

pages/common/black.md

@@ -1,6 +1,6 @@
 # black
 
-> A Python auto code formatter.
+> Format Python code automatically.
 > More information: <https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html>.
 
 - Auto-format a file or entire directory:

pages/common/c99.md

@@ -1,6 +1,6 @@
 # c99
 
-> Compiles C programs according to the ISO C standard.
+> Compile C programs according to the ISO C standard.
 > More information: <https://manned.org/c99>.
 
 - Compile source file(s) and create an executable:

pages/common/clamdscan.md

@@ -1,6 +1,6 @@
 # clamdscan
 
-> A command-line virus scanner using the ClamAV Daemon.
+> Scan for viruses using the ClamAV Daemon.
 > More information: <https://docs.clamav.net/manual/Usage/Scanning.html#clamdscan>.
 
 - Scan a file or directory for vulnerabilities:

pages/common/clang++.md

@@ -1,6 +1,6 @@
 # clang++
 
-> Compiles C++ source files.
+> Compile C++ source files.
 > Part of LLVM.
 > More information: <https://clang.llvm.org>.
 

pages/common/cmark.md

@@ -1,6 +1,6 @@
 # cmark
 
-> Converts CommonMark Markdown formatted text to other formats.
+> Convert CommonMark Markdown formatted text to other formats.
 > More information: <https://github.com/commonmark/cmark>.
 
 - Render a CommonMark Markdown file to HTML:

pages/common/coffee.md

@@ -1,6 +1,6 @@
 # coffee
 
-> Executes CoffeeScript scripts or compiles them into JavaScript.
+> Execute CoffeeScript scripts or compiles them into JavaScript.
 > More information: <https://coffeescript.org#cli>.
 
 - Run a script:

pages/common/complete.md

@@ -1,6 +1,6 @@
 # complete
 
-> Provides argument autocompletion to shell commands.
+> Get argument autocompletion to shell commands.
 > More information: <https://www.gnu.org/software/bash/manual/html_node/Programmable-Completion-Builtins.html>.
 
 - Apply a function that performs autocompletion to a command:

pages/common/cpio.md

@@ -1,6 +1,6 @@
 # cpio
 
-> Copies files in and out of archives.
+> Copy files in and out of archives.
 > Supports the following archive formats: cpio's custom binary, old ASCII, new ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar.
 > More information: <https://www.gnu.org/software/cpio>.
 

pages/common/cradle-install.md

@@ -1,6 +1,6 @@
 # cradle install
 
-> Installs the Cradle PHP framework components.
+> Install the Cradle PHP framework components.
 > More information: <https://cradlephp.github.io/docs/3.B.-Reference-Command-Line-Tools.html#install>.
 
 - Install Cradle's components (User will be prompted for further details):

pages/common/csslint.md

@@ -1,6 +1,6 @@
 # csslint
 
-> A linter for CSS code.
+> Lint CSS code.
 > More information: <https://github.com/CSSLint/csslint/wiki/Command-line-interface>.
 
 - Lint a single CSS file:

pages/common/csvclean.md

@@ -1,6 +1,6 @@
 # csvclean
 
-> Finds and cleans common syntax errors in CSV files.
+> Find and clean common syntax errors in CSV files.
 > Included in csvkit.
 > More information: <https://csvkit.readthedocs.io/en/latest/scripts/csvclean.html>.
 

pages/common/csvpy.md

@@ -1,6 +1,6 @@
 # csvpy
 
-> Loads a CSV file into a Python shell.
+> Load a CSV file into a Python shell.
 > Included in csvkit.
 > More information: <https://csvkit.readthedocs.io/en/latest/scripts/csvpy.html>.
 

pages/common/csvsort.md

@@ -1,6 +1,6 @@
 # csvsort
 
-> Sorts CSV files.
+> Sort CSV files.
 > Included in csvkit.
 > More information: <https://csvkit.readthedocs.io/en/latest/scripts/csvsort.html>.
 

pages/common/ctags.md

@@ -1,6 +1,6 @@
 # ctags
 
-> Generates an index (or tag) file of language objects found in source files for many popular programming languages.
+> Generate an index (or tag) file of language objects found in source files for many popular programming languages.
 > More information: <https://ctags.io/>.
 
 - Generate tags for a single file, and output them to a file named "tags" in the current directory, overwriting the file if it exists:

pages/common/dfc.md

@@ -1,6 +1,6 @@
 # dfc
 
-> Gives an overview of the filesystem disk space usage with colors and graphs.
+> Get an overview of the filesystem disk space usage with colors and graphs.
 > More information: <https://github.com/Rolinh/dfc>.
 
 - Display filesystems and their disk usage in human-readable form with colors and graphs:

pages/common/doctl-kubernetes-options.md

@@ -1,6 +1,6 @@
 # doctl kubernetes options
 
-> Provides values available for use with doctl's Kubernetes commands.
+> Get values available for use with `doctl`'s Kubernetes commands.
 > More information: <https://docs.digitalocean.com/reference/doctl/reference/kubernetes/options/>.
 
 - List regions that support Kubernetes clusters:

pages/common/doctum.md

@@ -1,6 +1,6 @@
 # doctum
 
-> A PHP API documentation generator.
+> Generate documentation for a PHP API.
 > More information: <https://github.com/code-lts/doctum>.
 
 - Parse a project:

pages/common/encfs.md

@@ -1,6 +1,6 @@
 # encfs
 
-> Mounts or creates encrypted virtual filesystems.
+> Mount or create encrypted virtual filesystems.
 > See also `fusermount`, which can unmount filesystems mounted by this command.
 > More information: <https://github.com/vgough/encfs>.
 

pages/common/gcloud-topic.md

@@ -1,6 +1,6 @@
 # gcloud topic
 
-> Provides supplementary help for topics not directly associated with individual commands. See also `gcloud`.
+> Display supplementary help for topics not directly associated with individual commands. See also `gcloud`.
 > For general help, see `tldr gcloud help`.
 > More information: <https://cloud.google.com/sdk/gcloud/reference/topic>.
 

pages/common/git-force-clone.md

@@ -1,6 +1,6 @@
 # git force-clone
 
-> Provides the basic functionality of `git clone`, but if the destination Git repository already exists it will force-reset it to resemble a clone of the remote.
+> Get the basic functionality of `git clone`, but if the destination Git repository already exists it will force-reset it to resemble a clone of the remote.
 > Part of `git-extras`.
 > More information: <https://github.com/tj/git-extras/blob/master/Commands.md#git-force-clone>.
 

pages/common/github-label-sync.md

@@ -1,6 +1,6 @@
 # github-label-sync
 
-> A command-line interface for synchronizing GitHub labels.
+> Synchronize GitHub labels.
 > More information: <https://github.com/Financial-Times/github-label-sync>.
 
 - Synchronize labels using a local `labels.json` file:

pages/common/gitk.md

@@ -1,6 +1,6 @@
 # gitk
 
-> A graphical Git repository browser.
+> Browse Git repositories graphically.
 > See also: `git-gui`, `git-cola`, `tig`.
 > More information: <https://git-scm.com/docs/gitk>.
 

pages/common/ical.md

@@ -1,6 +1,6 @@
 # ical
 
-> A Hirji/Islamic calendar and converter for the terminal.
+> View Hirji/Islamic and Gregorian calendars and convert their dates.
 > More information: <https://manned.org/ical>.
 
 - Display the current month's calendar:

pages/common/iconv.md

@@ -1,6 +1,6 @@
 # iconv
 
-> Converts text from one encoding to another.
+> Convert text from one encoding to another.
 > More information: <https://manned.org/iconv>.
 
 - Convert file to a specific encoding, and print to `stdout`:

pages/common/imgtoppm.md

@@ -1,6 +1,6 @@
 # imgtoppm
 
-> Converts various image file formats to the PPM (Portable Pixmap) format.
+> Convert various image file formats to the PPM (Portable Pixmap) format.
 > More information: <https://netpbm.sourceforge.net/doc/imgtoppm.html>.
 
 - Convert an input image to PPM format:

pages/common/in2csv.md

@@ -1,6 +1,6 @@
 # in2csv
 
-> Converts various tabular data formats into CSV.
+> Convert various tabular data formats to CSV.
 > Included in csvkit.
 > More information: <https://csvkit.readthedocs.io/en/latest/scripts/in2csv.html>.
 

pages/common/jc.md

@@ -1,6 +1,6 @@
 # jc
 
-> A utility to convert the output of multiple commands to JSON.
+> Convert the output of multiple commands to JSON.
 > More information: <https://github.com/kellyjonbrazil/jc>.
 
 - Convert command output to JSON via pipe:

pages/common/jpegtopnm.md

@@ -1,6 +1,6 @@
 # jpegtopnm
 
-> Converts a JPEG/JFIF file to the PPM or PGM format.
+> Convert a JPEG/JFIF file to the PPM or PGM format.
 > More information: <https://netpbm.sourceforge.net/doc/jpegtopnm.html>.
 
 - Convert JPEG/JFIF image to a PPM or PGM image:

pages/common/jq.md

@@ -1,6 +1,6 @@
 # jq
 
-> A command-line JSON processor that uses a domain-specific language (DSL).
+> A JSON processor that uses a domain-specific language (DSL).
 > More information: <https://jqlang.github.io/jq/manual/>.
 
 - Execute a specific expression (print a colored and formatted JSON output):

pages/common/llvm-dis.md

@@ -1,6 +1,6 @@
 # llvm-dis
 
-> Converts LLVM bitcode files into human-readable LLVM Intermediate Representation (IR).
+> Convert LLVM bitcode files into human-readable LLVM Intermediate Representation (IR).
 > More information: <https://www.llvm.org/docs/CommandGuide/llvm-dis.html>.
 
 - Convert a bitcode file as LLVM IR and write the result to `stdout`:

pages/common/md-to-clip.md

@@ -1,6 +1,6 @@
 # md-to-clip
 
-> Converter from tldr-pages to Command Line Interface Pages.
+> Convert tldr-pages to Command Line Interface Pages.
 > See also: `clip-view`.
 > More information: <https://github.com/command-line-interface-pages/v2-tooling/tree/main/md-to-clip>.
 

pages/common/mount.md

@@ -1,6 +1,6 @@
 # mount
 
-> Provides access to an entire filesystem in one directory.
+> Get access to an entire filesystem in one directory.
 > More information: <https://manned.org/mount.8>.
 
 - Show all mounted filesystems:

pages/common/nc.md

@@ -1,6 +1,6 @@
 # nc
 
-> A versatile utility for redirecting IO into a network stream.
+> Redirect I/O into a network stream through this versatile tool.
 > More information: <https://manned.org/man/nc.1>.
 
 - Start a listener on the specified TCP port and send a file into it:

pages/common/ned.md

@@ -1,6 +1,6 @@
 # ned
 
-> Is like `grep` but with powerful replace capabilities.
+> Like `grep` but with powerful replace capabilities.
 > Unlike `sed`, as it isn't restricted to line oriented editing.
 > More information: <https://github.com/nevdelap/ned>.
 

pages/common/nkf.md

@@ -1,7 +1,6 @@
 # nkf
 
-> Network kanji filter.
+> Network kanji filter: convert kanji code from one encoding to another.
-> Converts kanji code from one encoding to another.
 > More information: <https://manned.org/nkf>.
 
 - Convert to UTF-8 encoding:

pages/common/pdftocairo.md

@@ -1,6 +1,6 @@
 # pdftocairo
 
-> Converts PDF files to PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo.
+> Convert PDF files to PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo.
 > More information: <https://poppler.freedesktop.org>.
 
 - Convert a PDF file to JPEG:

pages/common/pnmtojpeg.md

@@ -1,6 +1,6 @@
 # pnmtojpeg
 
-> Converts a PNM image file to the JPEG/JFIF/EXIF image format.
+> Convert a PNM image file to the JPEG/JFIF/EXIF image format.
 > More information: <https://netpbm.sourceforge.net/doc/pnmtojpeg.html>.
 
 - Read a PNM image as input and produce a JPEG/JFIF/EXIF image as output:

pages/common/pnmtopng.md

@@ -1,6 +1,6 @@
 # pnmtopng
 
-> Converts a PNM image file to PNG image format.
+> Convert a PNM image file to PNG image format.
 > More information: <https://netpbm.sourceforge.net/doc/pnmtopng.html>.
 
 - Read a PNM image as input and produce a PNG image as output:

pages/common/sass.md

@@ -1,6 +1,6 @@
 # sass
 
-> Converts SCSS or Sass files to CSS.
+> Convert SCSS or Sass files to CSS.
 > More information: <https://sass-lang.com/documentation/cli/dart-sass>.
 
 - Convert a SCSS or Sass file to CSS and print out the result:

pages/common/st-info.md

@@ -1,6 +1,6 @@
 # st-info
 
-> Provides information about connected STLink and STM32 devices.
+> Get information about connected STLink and STM32 devices.
 > More information: <https://github.com/texane/stlink>.
 
 - Display amount of program memory available:

pages/common/timidity.md

@@ -1,6 +1,6 @@
 # timidity
 
-> A MIDI file player and converter.
+> Play and convert MIDI files.
 > More information: <http://timidity.sourceforge.net>.
 
 - Play a MIDI file:

pages/common/units.md

@@ -1,6 +1,6 @@
 # units
 
-> Provide the conversion between two units of measure.
+> Convert between two units of measure.
 > More information: <https://www.gnu.org/software/units/>.
 
 - Run in interactive mode:

pages/common/verilator.md

@@ -1,6 +1,6 @@
 # verilator
 
-> Converts Verilog and SystemVerilog hardware description language (HDL) design into a C++ or SystemC model to be executed after compiling.
+> Convert Verilog and SystemVerilog hardware description language (HDL) design into a C++ or SystemC model to be executed after compiling.
 > More information: <https://veripool.org/guide/latest/>.
 
 - Build a specific C project in the current directory:

pages/linux/arpaname.md

@@ -1,6 +1,6 @@
 # arpaname
 
-> Provides corresponding ARPA name for IP addresses.
+> Get the corresponding ARPA name for a IP addresses.
 > More information: <https://manned.org/arpaname>.
 
 - Translate IP addresses (IPv4 and IPv6) to the corresponding ARPA name:

pages/linux/cockpit-desktop.md

@@ -1,6 +1,6 @@
 # cockpit-desktop
 
-> Provides secure access to Cockpit pages in an already running session.
+> Securely access Cockpit pages in a running session.
 > It starts `cockpit-ws` and a web browser in an isolated network space and a `cockpit-bridge` in a running user session.
 > More information: <https://cockpit-project.org/guide/latest/cockpit-desktop.1.html>.
 

pages/linux/lsb_release.md

@@ -1,6 +1,6 @@
 # lsb_release
 
-> Provides certain LSB (Linux Standard Base) and distribution-specific information.
+> Get LSB (Linux Standard Base) and distribution-specific information.
 > More information: <https://manned.org/lsb_release>.
 
 - Print all available information:

pages/linux/reset.md

@@ -1,6 +1,6 @@
 # reset
 
-> Reinitializes the current terminal. Clears the entire terminal screen.
+> Reinitialize the current terminal. Clears the entire terminal screen.
 > More information: <https://manned.org/reset>.
 
 - Reinitialize the current terminal:

pages/linux/sa.md

@@ -1,7 +1,7 @@
 # sa
 
-> Summarizes accounting information. Part of the acct package.
+> Summarize accounting information about commands called by users, including basic information on CPU time spent processing and I/O rates.
-> Shows commands called by users, including basic info on CPU time spent processing and I/O rates.
+> Part of the `acct` package.
 > More information: <https://manned.org/man/sa.8>.
 
 - Display executable invocations per user (username not displayed):

pages/linux/slurmdbd.md

@@ -1,6 +1,6 @@
 # slurmdbd
 
-> Provides a secure enterprise-wide interface to a database for Slurm.
+> A secure enterprise-wide interface to a database for Slurm.
 > More information: <https://slurm.schedmd.com/slurmdbd.html>.
 
 - Set the daemon's nice value to the specified value, typically a negative number:

pages/linux/tcpkill.md

@@ -1,6 +1,6 @@
 # tcpkill
 
-> Kills specified in-progress TCP connections.
+> Kill specified in-progress TCP connections.
 > More information: <https://manned.org/tcpkill>.
 
 - Kill in-progress connections at a specified interface, host and port:

pages/linux/ul.md

@@ -1,6 +1,6 @@
 # ul
 
-> Performs the underlining of a text.
+> Underline a text.
 > Each character in a string must be underlined separately.
 > More information: <https://manned.org/ul>.
 

pages/linux/vncserver.md

@@ -1,6 +1,6 @@
 # vncserver
 
-> Launches a VNC (Virtual Network Computing) desktop.
+> Launch a VNC (Virtual Network Computing) desktop.
 > More information: <https://manned.org/vncserver.1x>.
 
 - Launch a VNC Server on next available display:

pages/linux/wal-telegram.md

@@ -1,6 +1,6 @@
 # wal-telegram
 
-> Generates themes for Telegram based the colors generated by pywal/wal.
+> Generate themes for Telegram based the colors generated by pywal/wal.
 > More information: <https://github.com/guillaumeboehm/wal-telegram>.
 
 - Generate with wal's palette and the current wallpaper (feh only):

pages/linux/xdg-open.md

@@ -1,6 +1,6 @@
 # xdg-open
 
-> Opens a file or URL in the user's preferred application.
+> Open a file or URL in the user's preferred application.
 > More information: <https://portland.freedesktop.org/doc/xdg-open.html>.
 
 - Open the current directory in the default file explorer:

pages/osx/appsleepd.md

@@ -1,6 +1,6 @@
 # appsleepd
 
-> Provides app sleep services.
+> Start app sleep services.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/appsleepd.8.html>.
 

pages/osx/autofsd.md

@@ -1,6 +1,6 @@
 # autofsd
 
-> Runs `automount` on startup and network configuration change events.
+> Run `automount` on startup and network configuration change events.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/autofsd.8.html>.
 

pages/osx/biometrickitd.md

@@ -1,6 +1,6 @@
 # biometrickitd
 
-> Provides support for biometric operations.
+> Get support for biometric operations.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/biometrickitd.8.html>.
 

pages/osx/cfprefsd.md

@@ -1,6 +1,6 @@
 # cfprefsd
 
-> Provides preferences services (`CFPreferences`, `NSUserDefaults`).
+> Start preferences services (`CFPreferences`, `NSUserDefaults`).
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/cfprefsd.8.html>.
 

pages/osx/distnoted.md

@@ -1,6 +1,6 @@
 # distnoted
 
-> Provides distributed notification services.
+> Start distributed notification services.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/distnoted.8.html>.
 

pages/osx/open.md

@@ -1,6 +1,6 @@
 # open
 
-> Opens files, directories and applications.
+> Open files, directories and applications.
 > More information: <https://keith.github.io/xcode-man-pages/open.1.html>.
 
 - Open a file with the associated application:

pages/osx/route.md

@@ -1,7 +1,7 @@
 # route
 
 > Manually manipulate the routing tables.
-> Necessitates to be root.
+> Requires root privileges.
 > More information: <https://keith.github.io/xcode-man-pages/route.8.html>.
 
 - Add a route to a destination through a gateway:

pages/osx/say.md

@@ -1,6 +1,6 @@
 # say
 
-> Converts text to speech.
+> Convert text to speech.
 > More information: <https://keith.github.io/xcode-man-pages/say.1.html>.
 
 - Say a phrase aloud:

pages/osx/scutil.md

@@ -1,7 +1,7 @@
 # scutil
 
 > Manage system configuration parameters.
-> Necessitates to be root when setting configuration.
+> Require root privileges when setting configuration.
 > More information: <https://keith.github.io/xcode-man-pages/scutil.8.html>.
 
 - Display DNS Configuration:

pages/osx/universalaccessd.md

@@ -1,6 +1,6 @@
 # universalaccessd
 
-> Provides universal access services.
+> Get universal access services.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/universalaccessd.8.html>.