netbpm tools: add option placeholders (#16048)

pages/common/anytopnm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`anytopnm -version`
+`anytopnm {{[-v|-version]}}`

pages/common/asciitopgm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`asciitopgm -version`
+`asciitopgm {{[-v|-version]}}`

pages/common/bioradtopgm.md

@@ -13,4 +13,4 @@
 
 - Display version:
 
-`bioradtopgm -version`
+`bioradtopgm {{[-v|-version]}}`

pages/common/bmptopnm.md

@@ -9,8 +9,8 @@
 
 - Report contents of the BMP header to `stderr`:
 
-`bmptopnm -verbose {{path/to/file.bmp}}`
+`bmptopnm {{[-verb|-verbose]}} {{path/to/file.bmp}}`
 
 - Display version:
 
-`bmptopnm -version`
+`bmptopnm {{[-v|-version]}}`

pages/common/brushtopbm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`brushtopbm -version`
+`brushtopbm {{[-v|-version]}}`

pages/common/fitstopnm.md

@@ -10,4 +10,4 @@
 
 - Convert the image on the specified position of the third axis in the FITS file:
 
-`fitstopnm -image {{z_position}} {{path/to/file.fits}} > {{path/to/output.pnm}}`
+`fitstopnm {{[-i|-image]}} {{z_position}} {{path/to/file.fits}} > {{path/to/output.pnm}}`

pages/common/gemtopnm.md

@@ -9,7 +9,7 @@
 
 - Describe the contents of the specified GEM image:
 
-`gemtopnm -d {{path/to/file.img}}`
+`gemtopnm {{[-d|-debug]}} {{path/to/file.img}}`
 
 - Display version:
 

pages/common/giftopnm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`giftopnm -version`
+`giftopnm {{[-v|-version]}}`

pages/common/hipstopgm.md

@@ -10,8 +10,8 @@
 
 - Suppress all informational messages:
 
-`hipstopgm -quiet`
+`hipstopgm {{[-q|-quiet]}}`
 
 - Display version:
 
-`hipstopgm -version`
+`hipstopgm {{[-v|-version]}}`

pages/common/ilbmtoppm.md

@@ -9,12 +9,12 @@
 
 - Use the specified color to "show through" where the image is transparent:
 
-`ilbmtoppm -transparent {{color}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`
+`ilbmtoppm {{[-t|-transparent]}} {{color}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`
 
 - Ignore the chunk with the specified chunk ID:
 
-`ilbmtoppm -ignore {{chunkID}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`
+`ilbmtoppm {{[-ig|-ignore]}} {{chunkID}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`
 
 - Store the input's transparency information to the specified PBM file:
 
-`ilbmtoppm -maskfile {{path/to/maskfile.pbm}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`
+`ilbmtoppm {{[-m|-maskfile]}} {{path/to/maskfile.pbm}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}`

pages/common/imgtoppm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`imgtoppm -version`
+`imgtoppm {{[-v|-version]}}`

pages/common/jpegtopnm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`jpegtopnm -version`
+`jpegtopnm {{[-v|-version]}}`

pages/common/leaftoppm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`leaftoppm -version`
+`leaftoppm {{[-v|-version]}}`

pages/common/macptopbm.md

@@ -10,12 +10,12 @@
 
 - Skip over `n` bytes when reading the file:
 
-`macptopbm -extraskip {{n}} > {{path/to/output.pbm}}`
+`macptopbm {{[-e|-extraskip]}} {{n}} > {{path/to/output.pbm}}`
 
 - Suppress all informational messages:
 
-`macptopbm -quiet > {{path/to/output.pbm}}`
+`macptopbm {{[-q|-quiet]}} > {{path/to/output.pbm}}`
 
 - Display version:
 
-`macptopbm -version`
+`macptopbm {{[-v|-version]}}`

pages/common/neotoppm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`neotoppm -version`
+`neotoppm {{[-v|-version]}}`

pages/common/palmtopnm.md

@@ -9,16 +9,16 @@
 
 - Display information about the input file:
 
-`palmtopnm -verbose {{path/to/file.palm}} > {{path/to/file.pnm}}`
+`palmtopnm {{[-verb|-verbose]}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
 - Convert the n'th rendition of the image contained in the input file:
 
-`palmtopnm -rendition {{n}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
+`palmtopnm {{[-r|-rendition]}} {{n}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
 - Write a histogram of the colors in the input file to `stdout`:
 
-`palmtopnm -showhist {{path/to/file.palm}} > {{path/to/file.pnm}}`
+`palmtopnm {{[-s|-showhist]}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
 - Output the transparent color of the input image if set:
 
-`palmtopnm -transparent {{path/to/file.palm}}`
+`palmtopnm {{[-t|-transparent]}} {{path/to/file.palm}}`

pages/common/pambrighten.md

@@ -5,8 +5,8 @@
 
 - Increase the saturation of each pixel by the specified percentage:
 
-`pambrighten -saturation {{value_percent}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+`pambrighten {{[-s|-saturation]}} {{value_percent}} {{path/to/image.pam}} > {{path/to/output.pam}}`
 
 - Increase the value (from the HSV color space) of each pixel by the specified percentage:
 
-`pambrighten -value {{value_percent}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+`pambrighten {{[-va|-value]}} {{value_percent}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pamcomp.md

@@ -9,12 +9,12 @@
 
 - Set the horizontal alignment of the overlay:
 
-`pamcomp -align {{left|center|right|beyondleft|beyondright}} -xoff {{x_offset}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`
+`pamcomp {{[-ali|-align]}} {{left|center|right|beyondleft|beyondright}} {{[-x|-xoff]}} {{x_offset}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`
 
 - Set the vertical alignment of the overlay:
 
-`pamcomp -valign {{top|middle|bottom|above|below}} -yoff {{y_offset}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`
+`pamcomp {{[-va|-valign]}} {{top|middle|bottom|above|below}} {{[-y|-yoff]}} {{y_offset}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`
 
 - Set the opacity of the overlay:
 
-`pamcomp -opacity {{0.7}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`
+`pamcomp {{[-o|-opacity]}} {{0.7}} {{path/to/overlay.pam}} {{path/to/underlay.pam}} > {{path/to/output.pam}}`

pages/common/pamcrater.md

@@ -6,8 +6,8 @@
 
 - Create an image of cratered terrain with the specified dimensions:
 
-`pamcrater -height {{height}} -width {{width}} > {{path/to/output.pam}}`
+`pamcrater {{[-h|-height]}} {{height}} {{[-w|-width]}} {{width}} > {{path/to/output.pam}}`
 
 - Create an image containing the specified number of craters:
 
-`pamcrater -number {{n_craters}} > {{path/to/output.pam}}`
+`pamcrater {{[-n|-number]}} {{n_craters}} > {{path/to/output.pam}}`

pages/common/pamcut.md

@@ -6,12 +6,12 @@
 
 - Discard the specified number of columns/rows on each side of the image:
 
-`pamcut -cropleft {{value}} -cropright {{value}} -croptop {{value}} -cropbottom {{value}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pamcut {{[-cropl|-cropleft]}} {{value}} {{[-cropr|-cropright]}} {{value}} {{[-cropt|-croptop]}} {{value}} {{[-cropb|-cropbottom]}} {{value}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
 
 - Keep only the columns between the specified columns (inclusively):
 
-`pamcut -left {{value}} -right {{value}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pamcut {{[-l|-left]}} {{value}} {{[-ri|-right]}} {{value}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
 
 - Fill missing areas with black pixels if the specified rectangle does not entirely lie within the input image:
 
-`pamcut -top {{value}} -bottom {{value}} -pad {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pamcut {{[-t|-top]}} {{value}} {{[-b|-bottom]}} {{value}} -pad {{path/to/image.ppm}} > {{path/to/output.ppm}}`

pages/common/pamdeinterlace.md

@@ -10,4 +10,4 @@
 
 - Produce an image consisting of the input's odd-numbered rows:
 
-`pamdeinterlace -takeodd {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pamdeinterlace {{[-takeo|-takeodd]}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`

pages/common/pamdice.md

@@ -6,8 +6,8 @@
 
 - Slice a Netpbm image such that the resulting tiles have the specified height and width:
 
-`pamdice -outstem {{path/to/filename_stem}} -height {{value}} -width {{value}} {{path/to/input.ppm}}`
+`pamdice {{[-o|-outstem]}} {{path/to/filename_stem}} {{[-he|-height]}} {{value}} {{[-w|-width]}} {{value}} {{path/to/input.ppm}}`
 
 - Make the produced pieces overlap by the specified amount horizontally and vertically:
 
-`pamdice -outstem {{path/to/filename_stem}} -height {{value}} -width {{value}} -hoverlap {{value}} -voverlap {{value}} {{path/to/input.ppm}}`
+`pamdice {{[-o|-outstem]}} {{path/to/filename_stem}} {{[-he|-height]}} {{value}} {{[-w|-width]}} {{value}} {{[-ho|-hoverlap]}} {{value}} {{[-vo|-voverlap]}} {{value}} {{path/to/input.ppm}}`

pages/common/pamditherbw.md

@@ -14,8 +14,8 @@
 
 - Use the atkinson quantization method and the specified seed for a pseudo-random number generator:
 
-`ppmditherbw -atkinson -randomseed {{1337}} {{path/to/image.pgm}} > {{path/to/file.pgm}}`
+`ppmditherbw {{[-a|-atkinson]}} {{[-r|-randomseed]}} {{1337}} {{path/to/image.pgm}} > {{path/to/file.pgm}}`
 
 - Specify the thresholding value for quantization methods that perform some sort of thresholding:
 
-`ppmditherbw -{{fs|atkinson|thresholding}} -value {{0.3}} {{path/to/image.pgm}} > {{path/to/file.pgm}}`
+`ppmditherbw -{{fs|atkinson|thresholding}} {{[-va|-value]}} {{0.3}} {{path/to/image.pgm}} > {{path/to/file.pgm}}`

pages/common/pamenlarge.md

@@ -6,8 +6,8 @@
 
 - Enlarge the specified image by the specified factor:
 
-`pamenlarge -scale {{n}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+`pamenlarge {{[-s|-scale]}} {{n}} {{path/to/image.pam}} > {{path/to/output.pam}}`
 
 - Enlarge the specified image by the specified factors horizontally and vertically:
 
-`pamenlarge -xscale {{xn}} -yscale {{yn}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+`pamenlarge {{[-x|-xscale]}} {{xn}} {{[-y|-yscale]}} {{yn}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pamexec.md

@@ -10,4 +10,4 @@
 
 - Stop processing if a command terminates with a nonzero exit status:
 
-`pamexec {{command}} {{path/to/image.pam}} -check`
+`pamexec {{command}} {{path/to/image.pam}} {{[-c|-check]}}`

pages/common/pamfile.md

@@ -9,8 +9,8 @@
 
 - Describe every image in each input file (as opposed to only the first image in each file) in a machine-readable format:
 
-`pamfile -allimages -machine {{path/to/file}}`
+`pamfile {{[-a|-allimages]}} -machine {{path/to/file}}`
 
 - Display a count on how many images the input files contain:
 
-`pamfile -count {{path/to/file}}`
+`pamfile {{[-cou|-count]}} {{path/to/file}}`

pages/common/pamfix.md

@@ -6,12 +6,12 @@
 
 - Fix a Netpbm file that is missing its last part:
 
-`pamfix -truncate {{path/to/corrupted.ext}} > {{path/to/output.ext}}`
+`pamfix {{[-t|-truncate]}} {{path/to/corrupted.ext}} > {{path/to/output.ext}}`
 
 - Fix a Netpbm file where pixel values exceed the image's `maxval` by lowering the offending pixels' values:
 
-`pamfix -clip {{path/to/corrupted.ext}} > {{path/to/output.ext}}`
+`pamfix {{[-cl|-clip]}} {{path/to/corrupted.ext}} > {{path/to/output.ext}}`
 
 - Fix a Netpbm file where pixel values exceed the image's `maxval` by increasing it:
 
-`pamfix -changemaxval {{path/to/corrupted.pam|pbm|pgm|ppm}} > {{path/to/output.pam|pbm|pgm|ppm}}`
+`pamfix {{[-ch|-changemaxval]}} {{path/to/corrupted.pam|pbm|pgm|ppm}} > {{path/to/output.pam|pbm|pgm|ppm}}`

pages/common/pamflip.md

@@ -5,16 +5,16 @@
 
 - Rotate the input image counter-clockwise for a specific degree:
 
-`pamflip -rotate{{90|180|270}} {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamflip {{[-r|-rotate]}}{{90|180|270}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Flip left for right:
 
-`pamflip -leftright {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamflip {{[-lr|-leftright]}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Flip top for bottom:
 
-`pamflip -topbottom {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamflip {{[-tb|-topbottom]}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Flip the input image on the main diagonal:
 
-`pamflip -transpose {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamflip {{[-xy|-transpose]}} {{path/to/input.pam}} > {{path/to/output.pam}}`

pages/common/pammixinterlace.md

@@ -10,8 +10,8 @@
 
 - Use the specified filtering mechanism:
 
-`pammixinterlace -filter {{linear|fir|ffmpeg}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pammixinterlace {{[-f|-filter]}} {{linear|fir|ffmpeg}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
 
 - Turn on adaptive filtering mode, i.e., only modify pixels that are obviously part of a comb pattern:
 
-`pammixinterlace -adaptive {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`pammixinterlace {{[-a|-adaptive]}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`

pages/common/pamscale.md

@@ -5,15 +5,15 @@
 
 - Scale an image such that the result has the specified dimensions:
 
-`pamscale -width {{width}} -height {{height}} {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamscale {{[-wid|-width]}} {{width}} {{[-h|-height]}} {{height}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Scale an image such that the result has the specified width, keeping the aspect ratio:
 
-`pamscale -width {{width}} {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamscale {{[-wid|-width]}} {{width}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Scale an image such that its width and height is changed by the specified factors:
 
-`pamscale -xscale {{x_factor}} -yscale {{y_factor}} {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamscale {{[-xsc|-xscale]}} {{x_factor}} {{[-ysc|-yscale]}} {{y_factor}} {{path/to/input.pam}} > {{path/to/output.pam}}`
 
 - Scale an image such that it fits into the specified bounding box while preserving its aspect ratio:
 

pages/common/pamshadedrelief.md

@@ -10,4 +10,4 @@
 
 - Gamma adjust the image by the specified factor:
 
-`pamshadedrelief -gamma {{factor}} < {{path/to/input.pam}} > {{path/to/output.pam}}`
+`pamshadedrelief {{[-g|-gamma]}} {{factor}} < {{path/to/input.pam}} > {{path/to/output.pam}}`

pages/common/pamslice.md

@@ -5,16 +5,16 @@
 
 - Print the values of the pixels in the n'th row in a table:
 
-`pamslice -row {{n}} {{path/to/image.pam}}`
+`pamslice {{[-r|-row]}} {{n}} {{path/to/image.pam}}`
 
 - Print the values of the pixels in the n'th column in a table:
 
-`pamslice -column {{n}} {{path/to/image.pam}}`
+`pamslice {{[-c|-column]}} {{n}} {{path/to/image.pam}}`
 
 - Consider the m'th plane of the input image only:
 
-`pamslice -row {{n}} -plane {{m}} {{path/to/image.pam}}`
+`pamslice {{[-r|-row]}} {{n}} -plane {{m}} {{path/to/image.pam}}`
 
 - Produce output in a format suitable for input to an `xmgr` for visualisation:
 
-`pamslice -row {{n}} -xmgr {{path/to/image.pam}}`
+`pamslice {{[-r|-row]}} {{n}} {{[-x|-xmgr]}} {{path/to/image.pam}}`

pages/common/pamstack.md

@@ -9,4 +9,4 @@
 
 - Specify the tuple type name of the output PAM file (maximum of 255 characters):
 
-`pamstack -tupletype {{tuple_type}} {{path/to/image1.pam path/to/image2.pam ...}} > {{path/to/output.pam}}`
+`pamstack {{[-t|-tupletype]}} {{tuple_type}} {{path/to/image1.pam path/to/image2.pam ...}} > {{path/to/output.pam}}`

pages/common/pamstretch.md

@@ -10,4 +10,4 @@
 
 - Scale up a PAM image by the specified factors in the horizontal and vertical directions:
 
-`pamstretch -xscale {{xn}} -yscale {{yn}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+`pamstretch {{[-x|-xscale]}} {{xn}} {{[-y|-yscale]}} {{yn}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pamtogif.md

@@ -10,8 +10,8 @@
 
 - Mark the specified color as transparent in the output GIF file:
 
-`pamtogif -transparent {{color}} {{path/to/image.pam}} > {{path/to/output.gif}}`
+`pamtogif {{[-t|-transparent]}} {{color}} {{path/to/image.pam}} > {{path/to/output.gif}}`
 
 - Include the specified text as a comment in the output GIF file:
 
-`pamtogif -comment "{{Hello World!}}" {{path/to/image.pam}} > {{path/to/output.gif}}`
+`pamtogif {{[-c|-comment]}} "{{Hello World!}}" {{path/to/image.pam}} > {{path/to/output.gif}}`

pages/common/pamtopam.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`pamtopam -version`
+`pamtopam {{[-v|-version]}}`

pages/common/pamtopng.md

@@ -10,12 +10,12 @@
 
 - Mark the specified color as transparent in the output image:
 
-`pamtopng -transparent {{color}} {{path/to/image.pam}} > {{path/to/output.png}}`
+`pamtopng {{[-t|-transparent]}} {{color}} {{path/to/image.pam}} > {{path/to/output.png}}`
 
 - Include the text in the specified file as tEXt chunks in the output:
 
-`pamtopng -text {{path/to/file.txt}} {{path/to/image.pam}} > {{path/to/output.png}}`
+`pamtopng {{[-te|-text]}} {{path/to/file.txt}} {{path/to/image.pam}} > {{path/to/output.png}}`
 
 - Cause the output file to be interlaced in Adam7 format:
 
-`pamtopng -interlace {{path/to/image.pam}} > {{path/to/output.png}}`
+`pamtopng {{[-in|-interlace]}} {{path/to/image.pam}} > {{path/to/output.png}}`

pages/common/pamtopnm.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`pamtopnm -version`
+`pamtopnm {{[-v|-version]}}`

pages/common/pamtotga.md

@@ -13,4 +13,4 @@
 
 - Display version:
 
-`pamtotga -version`
+`pamtotga {{[-v|-version]}}`

pages/common/pamtotiff.md

@@ -13,4 +13,4 @@
 
 - Always produce a color TIFF image, even if the input image is greyscale:
 
-`pamtotiff -color {{path/to/input_file.pam}} > {{path/to/output_file.tiff}}`
+`pamtotiff {{[-c|-color]}} {{path/to/input_file.pam}} > {{path/to/output_file.tiff}}`

pages/common/pamtouil.md

@@ -9,4 +9,4 @@
 
 - Specify a prefix string to be printed in the output UIL file:
 
-`pamtouil -name {{uilname}} {{path/to/input.pnm|pam}} > {{path/to/output.uil}}`
+`pamtouil {{[-n|-name]}} {{uilname}} {{path/to/input.pnm|pam}} > {{path/to/output.uil}}`

pages/common/pamtowinicon.md

@@ -9,8 +9,8 @@
 
 - Encode images with resolutions smaller than t in the BMP format and all other images in the PNG format:
 
-`pamtowinicon -pngthreshold {{t}} {{path/to/input_file.pam}} > {{path/to/output.ico}}`
+`pamtowinicon {{[-pn|-pngthreshold]}} {{t}} {{path/to/input_file.pam}} > {{path/to/output.ico}}`
 
 - Make all pixels outside the non-opaque area black:
 
-`pamtowinicon -truetransparent {{path/to/input_file.pam}} > {{path/to/output.ico}}`
+`pamtowinicon {{[-t|-truetransparent]}} {{path/to/input_file.pam}} > {{path/to/output.ico}}`

pages/common/pamundice.md

@@ -6,12 +6,12 @@
 
 - Combine the images whose names match the `printf`-style filename expression. Assume a grid with a specific size:
 
-`pamundice {{filename_%1d_%1a.ppm}} -across {{grid_width}} -down {{grid_height}} > {{path/to/output.ppm}}`
+`pamundice {{filename_%1d_%1a.ppm}} {{[-a|-across]}} {{grid_width}} {{[-d|-down]}} {{grid_height}} > {{path/to/output.ppm}}`
 
 - Assume that the tiles overlap horizontally and vertically by the specified amount:
 
-`pamundice {{filename_%1d_%1a.ppm}} -across {{x_value}} -down {{y_value}} -hoverlap {{value}} -voverlap {{value}} > {{path/to/output.ppm}}`
+`pamundice {{filename_%1d_%1a.ppm}} {{[-a|-across]}} {{x_value}} {{[-d|-down]}} {{y_value}} {{[-h|-hoverlap]}} {{value}} {{[-vo|-voverlap]}} {{value}} > {{path/to/output.ppm}}`
 
 - Specify the images to be combined through a text file containing one filename per line:
 
-`pamundice -listfile {{path/to/file.txt}} -across {{x_value}} -down {{y_value}} > {{path/to/output.ppm}}`
+`pamundice {{[-l|-listfile]}} {{path/to/file.txt}} {{[-a|-across]}} {{x_value}} {{[-d|-down]}} {{y_value}} > {{path/to/output.ppm}}`

pages/common/pbmclean.md

@@ -13,4 +13,4 @@
 
 - Specify the minimum number of neighbouring pixels of the same color in order for a pixel not to be considered isolated:
 
-`pbmclean -minneighbours {{3}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+`pbmclean {{[-m|-minneighbours]}} {{3}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmlife.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`pbmlife -version`
+`pbmlife {{[-v|-version]}}`

pages/common/pbmmask.md

@@ -10,4 +10,4 @@
 
 - Expand the generated mask by one pixel:
 
-`pbmmask -expand {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+`pbmmask {{[-r|-expand]}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmreduce.md

@@ -10,8 +10,8 @@
 
 - Use simple thresholding when reducing:
 
-`pbmreduce -threshold {{n}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+`pbmreduce {{[-t|-threshold]}} {{n}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
 
 - Use the specified threshold for all quantizations:
 
-`pbmreduce -value {{0.6}} {{n}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+`pbmreduce {{[-va|-value]}} {{0.6}} {{n}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmtext.md

@@ -14,8 +14,8 @@
 
 - Render text using a custom font supplied as a PBM file:
 
-`pbmtext -font {{path/to/font.pbm}} "{{Hello World!}}" > {{path/to/output.pbm}}`
+`pbmtext {{[-f|-font]}} {{path/to/font.pbm}} "{{Hello World!}}" > {{path/to/output.pbm}}`
 
 - Specify the number of pixels between characters and lines:
 
-`echo "{{Hello\nWorld!}}" | pbmtext -space {{3}} -lspace {{10}} > {{path/to/output.pbm}}`
+`echo "{{Hello\nWorld!}}" | pbmtext {{[-s|-space]}} {{3}} {{[-ls|-lspace]}} {{10}} > {{path/to/output.pbm}}`

pages/common/pbmtextps.md

@@ -14,8 +14,8 @@
 
 - Specify the desired left and top margins:
 
-`pbmtextps -leftmargin {{70}} -topmargin {{162}} "{{Hello World!}}" > {{path/to/output.pbm}}`
+`pbmtextps {{[-l|-leftmargin]}} {{70}} {{[-t|-topmargin]}} {{162}} "{{Hello World!}}" > {{path/to/output.pbm}}`
 
 - Do not output the rendered text as a PBM image, but a PostScript program that would create this image:
 
-`pbmtextps -dump-ps "{{Hello World!}}" > {{path/to/output.ps}}`
+`pbmtextps {{[-du|-dump-ps]}} "{{Hello World!}}" > {{path/to/output.ps}}`

pages/common/pbmtoascii.md

@@ -18,4 +18,4 @@
 
 - Display version:
 
-`pbmtoascii -version`
+`pbmtoascii {{[-v|-version]}}`

pages/common/pbmtoepsi.md

@@ -9,12 +9,12 @@
 
 - Produce a quadratic output image with the specified resolution:
 
-`pbmtoepsi -dpi {{144}} {{path/to/image.pbm}} > {{path/to/output.bmp}}`
+`pbmtoepsi {{[-d|-dpi]}} {{144}} {{path/to/image.pbm}} > {{path/to/output.bmp}}`
 
 - Produce an output image with the specified horizontal and vertical resolution:
 
-`pbmtoepsi -dpi {{72x144}} {{path/to/image.pbm}} > {{path/to/output.bmp}}`
+`pbmtoepsi {{[-d|-dpi]}} {{72x144}} {{path/to/image.pbm}} > {{path/to/output.bmp}}`
 
 - Only create a boundary box:
 
-`pbmtoepsi -bbonly {{path/to/image.pbm}} > {{path/to/output.bmp}}`
+`pbmtoepsi {{[-b|-bbonly]}} {{path/to/image.pbm}} > {{path/to/output.bmp}}`

pages/common/pbmtoepson.md

@@ -10,8 +10,8 @@
 
 - Specify the printer protocol of the output:
 
-`pbmtoepson -protocol {{escp9|escp}} {{path/to/image.pbm}} > {{path/to/output.epson}}`
+`pbmtoepson {{[-pr|-protocol]}} {{escp9|escp}} {{path/to/image.pbm}} > {{path/to/output.epson}}`
 
 - Specify the horizontal DPI of the output:
 
-`pbmtoepson -dpi {{60|72|80|90|120|144|240}} {{path/to/image.pbm}} > {{path/to/output.epson}}`
+`pbmtoepson {{[-d|-dpi]}} {{60|72|80|90|120|144|240}} {{path/to/image.pbm}} > {{path/to/output.epson}}`

pages/common/pbmtoescp2.md

@@ -10,12 +10,12 @@
 
 - Specify the compression of the output:
 
-`pbmtoescp2 -compression {{0|1}} {{path/to/image.pbm}} > {{path/to/output.escp2}}`
+`pbmtoescp2 {{[-c|-compression]}} {{0|1}} {{path/to/image.pbm}} > {{path/to/output.escp2}}`
 
 - Specify the horizontal and vertical resolution of the output in dots per inch:
 
-`pbmtoescp2 -resolution {{180|360|720}} {{path/to/image.pbm}} > {{path/to/output.escp2}}`
+`pbmtoescp2 {{[-re|-resolution]}} {{180|360|720}} {{path/to/image.pbm}} > {{path/to/output.escp2}}`
 
 - Place a formfeed command at the end of the output:
 
-`pbmtoescp2 -formfeed {{path/to/image.pbm}} > {{path/to/output.escp2}}`
+`pbmtoescp2 {{[-f|-formfeed]}} {{path/to/image.pbm}} > {{path/to/output.escp2}}`

pages/common/pbmtogem.md

@@ -10,8 +10,8 @@
 
 - Suppress all informational messages:
 
-`pbmtogem -quiet`
+`pbmtogem {{[-q|-quiet]}}`
 
 - Display version:
 
-`pbmtogem -version`
+`pbmtogem {{[-v|-version]}}`

pages/common/pbmtolj.md

@@ -13,4 +13,4 @@
 
 - Specify the required resolution:
 
-`pbmtolj -resolution {{75|100|150|300|600}} {{path/to/input.pbm}} > {{path/to/output.lj}}`
+`pbmtolj {{[-r|-resolution]}} {{75|100|150|300|600}} {{path/to/input.pbm}} > {{path/to/output.lj}}`

pages/common/pbmtomacp.md

@@ -10,4 +10,4 @@
 
 - Do not compress the output file:
 
-`pbmtomacp -norle {{path/to/image.pbm}} > {{path/to/output.macp}}`
+`pbmtomacp {{[-n|-norle]}} {{path/to/image.pbm}} > {{path/to/output.macp}}`

pages/common/pbmtonokia.md

@@ -5,24 +5,24 @@
 
 - Convert a PBM image into a Nokia Operator Logo as hexcode:
 
-`pbmtonokia -fmt NEX_NOL -net {{network_operator_code}} {{path/to/image.pbm}} > {{path/to/output.hex}}`
+`pbmtonokia {{[-f|-fmt]}} NEX_NOL -net {{network_operator_code}} {{path/to/image.pbm}} > {{path/to/output.hex}}`
 
 - Convert a PBM image into a Nokia Group Graphic as hexcode:
 
-`pbmtonokia -fmt NEX_NGG {{path/to/image.pbm}} > {{path/to/output.hex}}`
+`pbmtonokia {{[-f|-fmt]}} NEX_NGG {{path/to/image.pbm}} > {{path/to/output.hex}}`
 
 - Convert a PBM image into a Nokia Picture Message with the specified text as hexcode:
 
-`pbmtonokia -fmt NEX_NPM -txt {{text_message}} {{path/to/image.pbm}} > {{path/to/output.hex}}`
+`pbmtonokia {{[-f|-fmt]}} NEX_NPM -txt {{text_message}} {{path/to/image.pbm}} > {{path/to/output.hex}}`
 
 - Convert a PBM image into a Nokia Operator Logo as a NOL file:
 
-`pbmtonokia -fmt NOL {{path/to/image.pbm}} > {{path/to/output.nol}}`
+`pbmtonokia {{[-f|-fmt]}} NOL {{path/to/image.pbm}} > {{path/to/output.nol}}`
 
 - Convert a PBM image into a Nokia Group Graphic as an NGG file:
 
-`pbmtonokia -fmt NGG {{path/to/image.pbm}} > {{path/to/output.ngg}}`
+`pbmtonokia {{[-f|-fmt]}} NGG {{path/to/image.pbm}} > {{path/to/output.ngg}}`
 
 - Convert a PBM image into a Nokia Picture Message as an NPM file:
 
-`pbmtonokia -fmt NPM {{path/to/image.pbm}} > {{path/to/output.npm}}`
+`pbmtonokia {{[-f|-fmt]}} NPM {{path/to/image.pbm}} > {{path/to/output.npm}}`

pages/common/pcxtoppm.md

@@ -9,8 +9,8 @@
 
 - Use a predefined standard palette even if the PCX file provides one:
 
-`pcxtoppm -stdpalette {{path/to/file.pcx}} > {{path/to/file.ppm}}`
+`pcxtoppm {{[-s|-stdpalette]}} {{path/to/file.pcx}} > {{path/to/file.ppm}}`
 
 - Print information on the PCX header to `stdout`:
 
-`pcxtoppm -verbose {{path/to/file.pcx}} > {{path/to/file.ppm}}`
+`pcxtoppm {{[-verb|-verbose]}} {{path/to/file.pcx}} > {{path/to/file.ppm}}`

pages/common/pgmhist.md

@@ -10,16 +10,16 @@
 
 - Display the median grey value:
 
-`pgmhist -median {{path/to/image.pgm}}`
+`pgmhist {{[-me|-median]}} {{path/to/image.pgm}}`
 
 - Display four quartile grey value:
 
-`pgmhist -quartile {{path/to/image.pgm}}`
+`pgmhist {{[-qua|-quartile]}} {{path/to/image.pgm}}`
 
 - Report the existence of invalid grey values:
 
-`pgmhist -forensic {{path/to/image.pgm}}`
+`pgmhist {{[-f|-forensic]}} {{path/to/image.pgm}}`
 
 - Display machine-readable output:
 
-`pgmhist -machine {{path/to/image.pgm}}`
+`pgmhist {{[-ma|-machine]}} {{path/to/image.pgm}}`

pages/common/pgmkernel.md

@@ -14,4 +14,4 @@
 
 - Specify the weight of the center in the generated kernel:
 
-`pgmkernel -weight {{value}} {{width}} {{height}} > {{path/to/output.pgm}}`
+`pgmkernel {{[-w|-weight]}} {{value}} {{width}} {{height}} > {{path/to/output.pgm}}`

pages/common/pgmtoppm.md

@@ -5,8 +5,8 @@
 
 - Map all greyscale values of the input image to all colors between the two specified colors:
 
-`pgmtoppm -black {{red}} --white {{blue}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`
+`pgmtoppm {{[-b|-black]}} {{red}} {{[-w|-white]}} {{blue}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`
 
 - Map all greyscale values of the input image to colors according to the specified colormap:
 
-`pgmtoppm -map {{path/to/colormap.ppm}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`
+`pgmtoppm {{[-m|-map]}} {{path/to/colormap.ppm}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`

pages/common/picttoppm.md

@@ -9,8 +9,8 @@
 
 - Force any images in the PICT file to be output at full resolution:
 
-`picttoppm -fullres {{path/to/file.pict}} > {{path/to/file.ppm}}`
+`picttoppm {{[-fu|-fullres]}} {{path/to/file.pict}} > {{path/to/file.ppm}}`
 
 - Do not assume that the input file contains a PICT header and execute quickdraw operations only:
 
-`picttoppm -noheader -quickdraw {{path/to/file.pict}} > {{path/to/file.ppm}}`
+`picttoppm {{[-n|-noheader]}} {{[-quic|-quickdraw]}} {{path/to/file.pict}} > {{path/to/file.ppm}}`

pages/common/pngtopam.md

@@ -14,8 +14,8 @@
 
 - Replace transparent pixels by the specified color:
 
-`pngtopam -mix -background {{color}} {{path/to/image.png}} > {{path/to/output.pam}}`
+`pngtopam {{[-m|-mix]}} {{[-ba|-background]}} {{color}} {{path/to/image.png}} > {{path/to/output.pam}}`
 
 - Write tEXt chunks found in the input image to the specified text file:
 
-`pngtopam -text {{path/to/file.txt}} {{path/to/image.png}} > {{path/to/output.pam}}`
+`pngtopam {{[-te|-text]}} {{path/to/file.txt}} {{path/to/image.png}} > {{path/to/output.pam}}`

pages/common/pnmalias.md

@@ -13,8 +13,8 @@
 
 - Apply altialiasing to foreground pixels only:
 
-`pnmalias -fonly {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+`pnmalias {{[-fo|-fonly]}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`
 
 - Apply antialiasing to all surrounding pixels of background pixels:
 
-`pnmalias -balias {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+`pnmalias {{[-ba|-balias]}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`

pages/common/pnmcolormap.md

@@ -9,8 +9,8 @@
 
 - Use the splitspread strategy for determining the output colors, possibly producing a better result for images with small details:
 
-`pnmcolormap -splitspread {{n_colors}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+`pnmcolormap {{[-splits|-splitspread]}} {{n_colors}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`
 
 - Sort the resulting colormap, which is useful for comparing colormaps:
 
-`pnmcolormap -sort {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+`pnmcolormap {{[-so|-sort]}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`

pages/common/pnmcrop.md

@@ -5,11 +5,11 @@
 
 - Remove white borders on a PNM image:
 
-`pnmcrop -white {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmcrop {{[-w|-white]}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Remove borders of the specified color that are on the top and left side of the image:
 
-`pnmcrop -bg-color {{color}} -top -left {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmcrop -bg-color {{color}} {{[-t|-top]}} {{[-l|-left]}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Determine the color of the borders to be removed by the color of the pixel in the specified corner:
 
@@ -17,4 +17,4 @@
 
 - Leave a border with a width of `n` pixels. Additionally, specify the behaviour if the image is entirely made out of background:
 
-`pnmcrop -margins {{n}} -blank-image {{pass|minimize|maxcrop}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmcrop {{[-m|-margin]}} {{n}} {{[-blan|-blank-image]}} {{pass|minimize|maxcrop}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmgamma.md

@@ -13,8 +13,8 @@
 
 - Specify the gamma value used for the gamma transfer function:
 
-`pnmgamma -gamma {{value}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmgamma {{[-ga|-gamma]}} {{value}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Specify the gamma value used for the gamma transfer function per color component:
 
-`pnmgamma -rgamma {{value}} -ggamma {{value}} -bgamma {{value}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmgamma {{[-rg|-rgamma]}} {{value}} {{[-gg|-ggamma]}} {{value}} {{[-bg|-bgamma]}} {{value}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmhisteq.md

@@ -9,7 +9,7 @@
 
 - Only modify grey pixels:
 
-`pnmhisteq -grey {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmhisteq {{[-g|-grey]}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Do not include black or white pixels in the histogram equalization:
 

pages/common/pnmhistmap.md

@@ -9,8 +9,8 @@
 
 - Draw the histogram as dots instead of bars:
 
-`pnmhistmap -dots {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmhistmap {{[-d|-dots]}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Specify the range of intensity values to include:
 
-`pnmhistmap -lval {{minval}} -rval {{maxval}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmhistmap {{[-l|-lval]}} {{minval}} {{[-rv|-rval]}} {{maxval}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmindex.md

@@ -10,12 +10,12 @@
 
 - Specify the size of the (quadratic) thumbnails:
 
-`pnmindex -size {{50}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`
+`pnmindex {{[-s|-size]}} {{50}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`
 
 - Specify the number of thumbnails per row:
 
-`pnmindex -across {{10}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`
+`pnmindex {{[-a|-across]}} {{10}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`
 
 - Specify the maximum number of colors in the output:
 
-`pnmindex -colors {{512}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`
+`pnmindex {{[-c|-colors]}} {{512}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pnm}}`

pages/common/pnmmargin.md

@@ -9,4 +9,4 @@
 
 - Specify the color of the border:
 
-`pnmmargin -color {{color}} {{size}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmmargin {{[-c|-color]}} {{color}} {{size}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmmercator.md

@@ -10,4 +10,4 @@
 
 - Convert a Mercator projection worldmap to rectangular projection:
 
-`pnmmercator -inverse {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmmercator {{[-i|-inverse]}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmmontage.md

@@ -13,8 +13,8 @@
 
 - Produce a packing that is not larger than `p` percent of the optimal packing:
 
-`pnmmontage -quality {{p}} {{path/to/image1.pnm path/to/image2.pnm ...}} > {{path/to/output.pnm}}`
+`pnmmontage {{[-qua|-quality]}} {{p}} {{path/to/image1.pnm path/to/image2.pnm ...}} > {{path/to/output.pnm}}`
 
 - Write the positions of the input files within the packed image to a machine-readable file:
 
-`pnmmontage -data {{path/to/datafile}} {{path/to/image1.pnm path/to/image2.pnm ...}} > {{path/to/output.pnm}}`
+`pnmmontage {{[-d|-data]}} {{path/to/datafile}} {{path/to/image1.pnm path/to/image2.pnm ...}} > {{path/to/output.pnm}}`

pages/common/pnmnorm.md

@@ -10,11 +10,11 @@
 
 - Force the brightest pixels to be white, the darkest pixels to be black and spread out the ones in between quadratically such that pixels with a brightness of `n` become 50 % bright:
 
-`pnmnorm -midvalue {{n}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmnorm {{[-midv|-midvalue]}} {{n}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Keep the pixels' hue, only modify the brightness:
 
-`pnmnorm -keephues {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmnorm {{[-k|-keephues]}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Specify a method to calculate a pixel's brightness:
 

pages/common/pnmpad.md

@@ -6,16 +6,16 @@
 
 - Add borders of the specified sizes to the image:
 
-`pnmpad -left {{100}} -right {{150}} -top {{123}} -bottom {{456}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmpad {{[-l|-left]}} {{100}} {{[-ri|-right]}} {{150}} {{[-t|-top]}} {{123}} {{[-bo|-bottom]}} {{456}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Pad the image to the specified size:
 
-`pnmpad -width {{1000}} -height {{500}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmpad {{[-wi|-width]}} {{1000}} {{[-he|-height]}} {{500}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Pad the width of the image to the specified size, controlling the ratio between right and left padding:
 
-`pnmpad -width {{1000}} -halign {{0.7}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmpad {{[-wi|-width]}} {{1000}} {{[-ha|-halign]}} {{0.7}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
 
 - Pad the width of the image using the specified color:
 
-`pnmpad -width {{1000}} -color {{red}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
+`pnmpad {{[-wi|-width]}} {{1000}} {{[-c|-color]}} {{red}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmquantall.md

@@ -10,4 +10,4 @@
 
 - Save the quantised images to files named the same as the input files, but with the specified extension appended:
 
-`pnmquantall -ext {{extension}} {{n_colors}} {{path/to/input1.pnm path/to/input2.pnm ...}}`
+`pnmquantall {{[-e|-ext]}} {{extension}} {{n_colors}} {{path/to/input1.pnm path/to/input2.pnm ...}}`

pages/common/pnmremap.md

@@ -5,16 +5,16 @@
 
 - Replace the colors in an image with those in the specified color palette:
 
-`pnmremap -mapfile {{path/to/palette_file.ppm}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmremap {{[-ma|-mapfile]}} {{path/to/palette_file.ppm}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Use Floyd-Steinberg dithering for representing colors missing in the color palette:
 
-`pnmremap -mapfile {{path/to/palette_file.ppm}} -floyd {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmremap {{[-ma|-mapfile]}} {{path/to/palette_file.ppm}} {{[-fs|-floyd]}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Use the first color in the palette for representing colors missing in the color palette:
 
-`pnmremap -mapfile {{path/to/palette_file.ppm}} -firstisdefault {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmremap {{[-ma|-mapfile]}} {{path/to/palette_file.ppm}} {{[-fi|-firstisdefault]}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Use the specified color for representing colors missing in the color palette:
 
-`pnmremap -mapfile {{path/to/palette_file.ppm}} -missingcolor {{color}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmremap {{[-ma|-mapfile]}} {{path/to/palette_file.ppm}} {{[-m|-missingcolor]}} {{color}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmrotate.md

@@ -9,8 +9,8 @@
 
 - Specify the background color exposed by rotating the input image:
 
-`pnmrotate -background {{color}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmrotate {{[-b|-background]}} {{color}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Disable anti-aliasing, improving performance but decreasing quality:
 
-`pnmrotate -noantialias {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmrotate {{[-n|-noantialias]}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmscalefixed.md

@@ -6,12 +6,12 @@
 
 - Scale an image such that the result has the specified dimensions:
 
-`pnmscalefixed -width {{width}} -height {{height}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmscalefixed {{[-w|-width]}} {{width}} {{[-h|-height]}} {{height}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Scale an image such that the result has the specified width, keeping the aspect ratio:
 
-`pnmscalefixed -width {{width}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmscalefixed {{[-w|-width]}} {{width}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Scale an image such that its width and height is changed by the specified factors:
 
-`pnmscalefixed -xscale {{x_factor}} -yscale {{y_factor}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmscalefixed {{[-xsc|-xscale]}} {{x_factor}} {{[-ysc|-yscale]}} {{y_factor}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmshear.md

@@ -9,8 +9,8 @@
 
 - Specify the color of the background in the sheared image:
 
-`pnmshear -background {{blue}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmshear {{[-b|-background]}} {{blue}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
 
 - Do not perform anti-aliasing:
 
-`pnmshear -noantialias {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmshear {{[-n|-noantialias]}} {{angle}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmsmooth.md

@@ -9,4 +9,4 @@
 
 - Smooth out a PNM image using a convolution matrix of size width times height:
 
-`pnmsmooth -width {{width}} -height {{height}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`
+`pnmsmooth {{[-w|-width]}} {{width}} {{[-h|-height]}} {{height}} {{path/to/input.pnm}} > {{path/to/output.pnm}}`

pages/common/pnmtoddif.md

@@ -9,4 +9,4 @@
 
 - Explicitly specify the horizontal and vertical resolution of the output image:
 
-`pnmtoddif -resolution {{horizontal_dpi}} {{vertical_dpi}} {{path/to/image.pnm}} > {{path/to/image.ddif}}`
+`pnmtoddif {{[-r|-resolution]}} {{horizontal_dpi}} {{vertical_dpi}} {{path/to/image.pnm}} > {{path/to/image.ddif}}`

pages/common/pnmtofiasco.md

@@ -13,7 +13,7 @@
 
 - Specify the compression quality:
 
-`pnmtofiasco {{[-q|--quality]}} {{quality_level}} {{path/to/file.pnm}} > {{path/to/file.fiasco}}`
+`pnmtofiasco {{[-qua|--quality]}} {{quality_level}} {{path/to/file.pnm}} > {{path/to/file.fiasco}}`
 
 - Load the options to be used from the specified configuration file:
 

pages/common/pnmtopalm.md

@@ -9,7 +9,7 @@
 
 - Specify the color depth of the resulting bitmap:
 
-`pnmtopalm -depth {{1|2|4|8|16}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
+`pnmtopalm {{[-dep|-depth]}} {{1|2|4|8|16}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
 
 - Choose a compression method for the resulting bitmap:
 
@@ -17,8 +17,8 @@
 
 - Build a custom colormap and include it in the resulting bitmap:
 
-`pnmtopalm -colormap {{path/to/file.pnm}} > {{path/to/file.palm}}`
+`pnmtopalm {{[-c|-colormap]}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
 
 - Specify the bitmap's density:
 
-`pnmtopalm -density {{72|108|144|216|288}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
+`pnmtopalm {{[-den|-density]}} {{72|108|144|216|288}} {{path/to/file.pnm}} > {{path/to/file.palm}}`

pages/common/pnmtopclxl.md

@@ -9,8 +9,8 @@
 
 - Specify the resolution of the image as well as the location of the page from the upper left corner of each image:
 
-`pnmtopclxl -dpi {{resolution}} -xoffs {{x_offset}} -yoffs {{y_offset}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pclxl}}`
+`pnmtopclxl -dpi {{resolution}} {{[-x|-xoffs]}} {{x_offset}} {{[-y|-yoffs]}} {{y_offset}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pclxl}}`
 
 - Generate a duplex printer stream for the specified paper format:
 
-`pnmtopclxl -duplex {{vertical|horizontal}} -format {{letter|legal|a3|a4|a5|...}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pclxl}}`
+`pnmtopclxl {{[-du|-duplex]}} {{vertical|horizontal}} {{[-fo|-format]}} {{letter|legal|a3|a4|a5|...}} {{path/to/input1.pnm path/to/input2.pnm ...}} > {{path/to/output.pclxl}}`

pages/common/pnmtopng.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`pnmtopng -version`
+`pnmtopng {{[-vers|-version]}}`

pages/common/pnmtops.md

@@ -9,8 +9,8 @@
 
 - Specify the dimensions of the output image in inches:
 
-`pnmtops -imagewidth {{imagewidth}} -imageheight {{imageheight}} {{path/to/file.pnm}} > {{path/to/file.ps}}`
+`pnmtops {{[-imagew|-imagewidth]}} {{imagewidth}} {{[-imageh|-imageheight]}} {{imageheight}} {{path/to/file.pnm}} > {{path/to/file.ps}}`
 
 - Specify the dimensions of the page the output image resides on in inches:
 
-`pnmtops -width {{width}} -height {{height}} {{path/to/file.pnm}} > {{path/to/file.ps}}`
+`pnmtops {{[-w|-width]}} {{width}} {{[-h|-height]}} {{height}} {{path/to/file.pnm}} > {{path/to/file.ps}}`

pages/common/pnmtorle.md

@@ -9,8 +9,8 @@
 
 - Print PNM header information to `stdout`:
 
-`pnmtorle -verbose {{path/to/input.pnm}} > {{path/to/output.rle}}`
+`pnmtorle {{[-verb|-verbose]}} {{path/to/input.pnm}} > {{path/to/output.rle}}`
 
 - Include a transparency channel in the output image in which every black pixel is set to fully transparent and every other pixel is set to fully opaque:
 
-`pnmtorle -alpha {{path/to/input.pnm}} > {{path/to/output.rle}}`
+`pnmtorle {{[-a|-alpha]}} {{path/to/input.pnm}} > {{path/to/output.rle}}`

pages/common/pnmtosgi.md

@@ -13,4 +13,4 @@
 
 - Write the specified string into the SGI image header's `imagename` field:
 
-`pnmtosgi -imagename {{string}} {{path/to/input.pnm}} > {{path/to/output.sgi}}`
+`pnmtosgi {{[-i|-imagename]}} {{string}} {{path/to/input.pnm}} > {{path/to/output.sgi}}`

pages/common/pnmtoxwd.md

@@ -9,8 +9,8 @@
 
 - Produce the output in the DirectColor format:
 
-`pnmtoxwd -directcolor {{path/to/input_file.pnm}} > {{path/to/output_file.xwd}}`
+`pnmtoxwd {{[-d|-directcolor]}} {{path/to/input_file.pnm}} > {{path/to/output_file.xwd}}`
 
 - Set the color depth of the output to b bits:
 
-`pnmtoxwd -pseudodepth {{b}} {{path/to/input_file.pnm}} > {{path/to/output_file.xwd}}`
+`pnmtoxwd {{[-ps|-pseudodepth]}} {{b}} {{path/to/input_file.pnm}} > {{path/to/output_file.xwd}}`

pages/common/ppmchange.md

@@ -13,4 +13,4 @@
 
 - Replace all pixels not specified in the arguments by a color:
 
-`ppmchange -remainder {{color}} {{oldcolor1 newcolor1 oldcolor2 newcolor2 ...}} {{path/to/input.ppm}} > {{path/to/output.ppm}}`
+`ppmchange {{[-r|-remainder]}} {{color}} {{oldcolor1 newcolor1 oldcolor2 newcolor2 ...}} {{path/to/input.ppm}} > {{path/to/output.ppm}}`

pages/common/ppmcie.md

@@ -17,4 +17,4 @@
 
 - Do not dim the area outside the Maxwell triangle:
 
-`ppmcie -full > {{path/to/output.ppm}}`
+`ppmcie {{[-f|-full]}} > {{path/to/output.ppm}}`

pages/common/ppmcolormask.md

@@ -5,4 +5,4 @@
 
 - Produce a mask of areas of a certain color in the specified PPM image:
 
-`ppmcolormask -color {{red,blue}} {{path/to/input.ppm}} > {{path/to/output.pbm}}`
+`ppmcolormask {{[-c|-color]}} {{red,blue}} {{path/to/input.ppm}} > {{path/to/output.pbm}}`

pages/common/ppmdither.md

@@ -9,8 +9,8 @@
 
 - Specify the desired number of shades for each primary color:
 
-`ppmdither -red {{2}} -green {{3}} -blue {{2}} {{path/to/image.ppm}} > {{path/to/file.ppm}}`
+`ppmdither {{[-r|-red]}} {{2}} {{[-g|-green]}} {{3}} {{[-b|-blue]}} {{2}} {{path/to/image.ppm}} > {{path/to/file.ppm}}`
 
 - Specify the dimensions of the dithering matrix:
 
-`ppmdither -dim {{2}} {{path/to/image.ppm}} > {{path/to/file.ppm}}`
+`ppmdither {{[-d|-dim]}} {{2}} {{path/to/image.ppm}} > {{path/to/file.ppm}}`

pages/common/ppmflash.md

@@ -9,4 +9,4 @@
 
 - Display version:
 
-`ppmflash -version`
+`ppmflash {{[-v|-version]}}`

pages/common/ppmforge.md

@@ -13,8 +13,8 @@
 
 - Use a custom mesh size and dimension for fractal generation and specify the dimensions of the output:
 
-`ppmforge -mesh {{512}} -dimension {{2.5}} -xsize {{1000}} -ysize {{1000}} > {{path/to/image.ppm}}`
+`ppmforge {{[-m|-mesh]}} {{512}} {{[-d|-dimension]}} {{2.5}} {{[-x|-xsize]}} {{1000}} {{[-y|-ysize]}} {{1000}} > {{path/to/image.ppm}}`
 
 - Control the tilt and the angle from which the generated planet is illuminated:
 
-`ppmforge -tilt {{-15}} -hour {{12}} > {{path/to/image.ppm}}`
+`ppmforge {{[-t|-tilt]}} {{-15}} {{[-ho|-hour]}} {{12}} > {{path/to/image.ppm}}`

pages/common/ppmglobe.md

@@ -10,4 +10,4 @@
 
 - Use the specified color for the areas between the strips:
 
-`ppmglobe -background {{red}} {{number_of_strips}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`
+`ppmglobe {{[-b|-background]}} {{red}} {{number_of_strips}} {{path/to/image.ppm}} > {{path/to/output.ppm}}`

pages/common/ppmhist.md

@@ -6,12 +6,12 @@
 
 - Generate the histogram for human reading:
 
-`ppmhist -nomap {{path/to/image.ppm}}`
+`ppmhist {{[-nom|-nomap]}} {{path/to/image.ppm}}`
 
 - Generate a PPM file of the colormap for the image, with the color histogram as comments:
 
-`ppmhist -map {{path/to/image.ppm}}`
+`ppmhist {{[-m|-map]}} {{path/to/image.ppm}}`
 
 - Display version:
 
-`ppmhist -version`
+`ppmhist {{[-v|-version]}}`

pages/common/ppmlabel.md

@@ -5,12 +5,12 @@
 
 - Add text to a PPM image at the specified location:
 
-`ppmlabel -x {{pos_x}} -y {{pos_y}} -text {{text}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
+`ppmlabel -x {{pos_x}} -y {{pos_y}} {{[-t|-text]}} {{text}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
 
 - Add multiple texts at different locations:
 
-`ppmlabel -x {{pos_x1}} -y {{pos_y1}} -text {{text1}} -x {{pos_x2}} -y {{pos_y2}} -text {{text2}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
+`ppmlabel -x {{pos_x1}} -y {{pos_y1}} {{[-t|-text]}} {{text1}} -x {{pos_x2}} -y {{pos_y2}} {{[-t|-text]}} {{text2}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
 
 - Specify the line color, the background color, the tilt and the size of the added text:
 
-`ppmlabel -x {{pos_x}} -y {{pos_y}} -color {{line_color}} -background {{background_color}} -angle {{tilt}} -size {{size}} -text {{text}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
+`ppmlabel -x {{pos_x}} -y {{pos_y}} {{[-c|-color]}} {{line_color}} {{[-b|-background]}} {{background_color}} {{[-a|-angle]}} {{tilt}} {{[-s|-size]}} {{size}} {{[-t|-text]}} {{text}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`

pages/common/ppmntsc.md

@@ -13,7 +13,7 @@
 
 - Print the number of illegal pixels in the input image to `stderr`:
 
-`ppmntsc --verbose {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
+`ppmntsc {{[--verb|--verbose]}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}`
 
 - Output only legal/illegal/corrected pixels, set other pixels to black: