Add commands

Author: SimonSchubert

assets/commands/Xorg.md

@@ -0,0 +1,91 @@
+# TLDR
+
+**Start X server** on default display
+
+```Xorg```
+
+**Start on specific display**
+
+```Xorg :1```
+
+**Configure and test** without starting
+
+```Xorg -configure```
+
+**Start with specific config file**
+
+```Xorg -config [/path/to/xorg.conf]```
+
+**Start on specific virtual terminal**
+
+```Xorg vt7```
+
+**Query supported modes** for display
+
+```Xorg -query [hostname]```
+
+**Retro probe only** (no server start)
+
+```Xorg -retro -probeonly```
+
+# SYNOPSIS
+
+**Xorg** [**:**_DISPLAY_] [_OPTIONS_]
+
+# PARAMETERS
+
+**:**_DISPLAY_
+> Display number to use (default: 0).
+
+**-config** _FILE_
+> Use specified configuration file instead of default.
+
+**-configure**
+> Probe hardware and generate xorg.conf.
+
+**-logfile** _FILE_
+> Write log to specified file.
+
+**-modulepath** _PATH_
+> Search path for loadable modules.
+
+**-retro**
+> Start with classic X stipple background.
+
+**-probeonly**
+> Probe hardware without starting server.
+
+**-query** _HOST_
+> Connect to XDMCP host.
+
+**-verbose** [_N_]
+> Verbosity level (0-7).
+
+**vt**_N_
+> Use virtual terminal N.
+
+**-nolisten** _PROTO_
+> Disable listening on protocol (e.g., tcp).
+
+**-novtswitch**
+> Don't automatically switch VT at startup.
+
+# DESCRIPTION
+
+**Xorg** is the X Window System server implementation from X.Org Foundation. It provides the foundation for graphical user interfaces on Unix-like systems, managing displays, input devices, and graphics hardware.
+
+The server reads configuration from /etc/X11/xorg.conf or files in /etc/X11/xorg.conf.d/. Modern systems often run without explicit configuration, relying on automatic hardware detection.
+
+Xorg is typically started by a display manager (GDM, SDDM, LightDM) or the **startx** script rather than directly. It runs on a virtual terminal and provides the display connection for X clients.
+
+# CAVEATS
+
+Running Xorg requires appropriate permissions (typically root or membership in video group). Many systems now use Wayland compositors instead of Xorg. Configuration errors can leave the system without a graphical interface; keep a backup configuration or use fallback options.
+
+# HISTORY
+
+X.Org Server is the successor to XFree86 and the reference implementation of the X Window System. The X.Org Foundation was formed in **2004** after a licensing dispute with XFree86. Xorg has been the standard X server on Linux and BSD systems, though Wayland is increasingly replacing it for desktop use.
+
+# SEE ALSO
+
+[startx](/man/startx)(1), [xinit](/man/xinit)(1), [xrandr](/man/xrandr)(1), [xorg.conf](/man/xorg.conf)(5)

assets/commands/pnmcolormap.md

@@ -0,0 +1,73 @@
+# TLDR
+
+**Generate color map with N colors**
+
+```pnmcolormap [256] [image.ppm] > [colormap.ppm]```
+
+**Use median cut algorithm**
+
+```pnmcolormap -center [16] [image.ppm] > [colormap.ppm]```
+
+**Spread colors evenly**
+
+```pnmcolormap -spreadluminosity [256] [image.ppm] > [colormap.ppm]```
+
+**From multiple images**
+
+```pnmcolormap [256] [image1.ppm] [image2.ppm] > [colormap.ppm]```
+
+# SYNOPSIS
+
+**pnmcolormap** [_options_] _ncolors_ [_pnmfile_...]
+
+# PARAMETERS
+
+**ncolors**
+> Maximum colors in map.
+
+**-center**
+> Use center of cluster.
+
+**-meancolor**
+> Use mean color of cluster.
+
+**-meanpixel**
+> Use mean weighted by pixel count.
+
+**-spreadbrightness**
+> Spread by brightness.
+
+**-spreadluminosity**
+> Spread by luminosity.
+
+# DESCRIPTION
+
+**pnmcolormap** creates a color map (palette) from an image using median cut quantization. The output is a small image where each pixel is a color from the palette.
+
+Used with pnmremap for color reduction.
+
+# EXAMPLES
+
+```bash
+# Create 256-color palette
+pnmcolormap 256 photo.ppm > palette.ppm
+
+# Reduce colors using map
+pnmcolormap 16 image.ppm > map.ppm
+pnmremap -mapfile=map.ppm image.ppm > reduced.ppm
+
+# Combined color reduction
+pnmcolormap 256 image.ppm | pnmremap -mapfile=- image.ppm > reduced.ppm
+```
+
+# CAVEATS
+
+Output is the colormap, not the remapped image. Use pnmremap to apply. Part of Netpbm.
+
+# HISTORY
+
+pnmcolormap is part of **Netpbm**, implementing median-cut color quantization algorithm.
+
+# SEE ALSO
+
+[pnmremap](/man/pnmremap)(1), [ppmquant](/man/ppmquant)(1), [ppmquantall](/man/ppmquantall)(1), [netpbm](/man/netpbm)(1)

assets/commands/pnmcut.md

@@ -0,0 +1,78 @@
+# TLDR
+
+**Cut rectangular region**
+
+```pnmcut [x] [y] [width] [height] [input.pnm] > [output.pnm]```
+
+**Cut from top-left corner**
+
+```pnmcut -left [0] -top [0] -width [100] -height [100] [input.pnm] > [output.pnm]```
+
+**Cut using bottom-right**
+
+```pnmcut -left [10] -top [10] -right [200] -bottom [150] [input.pnm] > [output.pnm]```
+
+**Pad if outside bounds**
+
+```pnmcut -pad [x] [y] [width] [height] [input.pnm] > [output.pnm]```
+
+# SYNOPSIS
+
+**pnmcut** [_options_] _x_ _y_ _width_ _height_ [_pnmfile_]
+
+# PARAMETERS
+
+**-left** _n_
+> Left column.
+
+**-right** _n_
+> Right column.
+
+**-top** _n_
+> Top row.
+
+**-bottom** _n_
+> Bottom row.
+
+**-width** _n_
+> Width in pixels.
+
+**-height** _n_
+> Height in pixels.
+
+**-pad**
+> Pad with black if out of bounds.
+
+# DESCRIPTION
+
+**pnmcut** extracts a rectangular region from a PNM image. Coordinates are zero-indexed from top-left corner.
+
+Part of Netpbm toolkit for image manipulation.
+
+# EXAMPLES
+
+```bash
+# Cut 100x100 from position 50,50
+pnmcut 50 50 100 100 image.ppm > crop.ppm
+
+# Using named parameters
+pnmcut -left 100 -top 100 -width 200 -height 150 image.ppm > crop.ppm
+
+# Cut with padding
+pnmcut -pad -10 -10 120 120 image.ppm > padded.ppm
+
+# Chain with conversion
+jpegtopnm photo.jpg | pnmcut 0 0 640 480 | pnmtojpeg > thumb.jpg
+```
+
+# CAVEATS
+
+Superseded by pamcut with more features. Negative coordinates cut from opposite edge.
+
+# HISTORY
+
+pnmcut is part of **Netpbm** by **Jef Poskanzer**, providing basic cropping functionality.
+
+# SEE ALSO
+
+[pamcut](/man/pamcut)(1), [pnmpaste](/man/pnmpaste)(1), [pnmcrop](/man/pnmcrop)(1), [netpbm](/man/netpbm)(1)

assets/commands/pnmhisteq.md

@@ -0,0 +1,60 @@
+# TLDR
+
+**Equalize histogram**
+
+```pnmhisteq [input.pnm] > [output.pnm]```
+
+**Verbose output**
+
+```pnmhisteq -verbose [input.pnm] > [output.pnm]```
+
+**Equalize grayscale**
+
+```ppmtopgm [input.ppm] | pnmhisteq > [output.pgm]```
+
+# SYNOPSIS
+
+**pnmhisteq** [_options_] [_pnmfile_]
+
+# PARAMETERS
+
+**-gray**
+> Equalize on gray value.
+
+**-verbose**
+> Print information.
+
+# DESCRIPTION
+
+**pnmhisteq** performs histogram equalization on a PNM image. This process spreads out the most frequent intensity values, improving contrast in images with clustered brightness levels.
+
+Part of Netpbm toolkit for image enhancement.
+
+# EXAMPLES
+
+```bash
+# Basic histogram equalization
+pnmhisteq photo.pgm > enhanced.pgm
+
+# Color image via grayscale
+jpegtopnm photo.jpg | pnmhisteq > enhanced.ppm
+
+# Chain with conversion
+pnmhisteq dark.pgm | pnmtopng > enhanced.png
+```
+
+# ALGORITHM
+
+Histogram equalization maps input intensities to output intensities so that the output histogram is approximately uniform. This maximizes image contrast.
+
+# CAVEATS
+
+May increase noise in uniform areas. Results depend on image content. Better for grayscale than color images.
+
+# HISTORY
+
+pnmhisteq is part of **Netpbm** by **Jef Poskanzer** and contributors, implementing classic histogram equalization.
+
+# SEE ALSO
+
+[pgmhist](/man/pgmhist)(1), [pnmnorm](/man/pnmnorm)(1), [pgmenhance](/man/pgmenhance)(1), [netpbm](/man/netpbm)(1)

assets/commands/pnmindex.md

@@ -0,0 +1,75 @@
+# TLDR
+
+**Create image index**
+
+```pnmindex [image1.pnm] [image2.pnm] [image3.pnm] > [index.pnm]```
+
+**Specify size**
+
+```pnmindex -size [100] [*.pnm] > [index.pnm]```
+
+**With labels**
+
+```pnmindex -title [*.pnm] > [index.pnm]```
+
+**Multiple columns**
+
+```pnmindex -across [4] [*.pnm] > [index.pnm]```
+
+# SYNOPSIS
+
+**pnmindex** [_options_] _pnmfiles_...
+
+# PARAMETERS
+
+**-size** _n_
+> Size of each thumbnail.
+
+**-across** _n_
+> Number of images per row.
+
+**-colors** _n_
+> Number of colors.
+
+**-title**
+> Add filenames as titles.
+
+**-black**
+> Black background.
+
+**-quant**
+> Quantize colors.
+
+# DESCRIPTION
+
+**pnmindex** creates a visual index (contact sheet) from multiple PNM images. Each image is scaled to a thumbnail and arranged in a grid.
+
+Useful for creating image previews and galleries.
+
+# EXAMPLES
+
+```bash
+# Create index of all PPM files
+pnmindex *.ppm > index.ppm
+
+# Thumbnails 150 pixels, 5 across
+pnmindex -size 150 -across 5 photos/*.ppm > gallery.ppm
+
+# With labels on black
+pnmindex -title -black images/*.pnm > contact.ppm
+
+# Convert to JPEG
+pnmindex *.pnm | pnmtojpeg > index.jpg
+```
+
+# CAVEATS
+
+Large numbers of images can produce huge output. Consider pamundice for splitting back.
+
+# HISTORY
+
+pnmindex is part of **Netpbm**, providing contact sheet generation since early Pbmplus versions.
+
+# SEE ALSO
+
+[pnmcat](/man/pnmcat)(1), [pnmscale](/man/pnmscale)(1), [pnmtile](/man/pnmtile)(1), [netpbm](/man/netpbm)(1)