Merge 7f290aebc8 into 5905e786ab

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/leaftoppm.md

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

pages/common/neotoppm.md

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

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 {{[-v|-value]}} {{value_percent}} {{path/to/image.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/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/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/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}} {{[-p|-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/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/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 {{[-v|-verbose]}} {{path/to/file.pcx}} > {{path/to/file.ppm}}`

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]}} {{[-q|-quickdraw]}} {{path/to/file.pict}} > {{path/to/file.ppm}}`

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/ppmpat.md

@@ -9,4 +9,4 @@
 
 - Produce a PPM file of a camo pattern using the specified colors:
 
-`ppmpat -camo -color {{color1,color2,...}} {{width}} {{height}} > {{path/to/file.ppm}}`
+`ppmpat {{[-ca|-camo]}} {{[-co|-color]}} {{color1,color2,...}} {{width}} {{height}} > {{path/to/file.ppm}}`

pages/common/ppmrainbow.md

@@ -9,8 +9,8 @@
 
 - Specify the size of the output in pixels:
 
-`ppmrainbow -width {{width}} -height {{height}} {{color1 color2 ...}} > {{path/to/output_file.ppm}}`
+`ppmrainbow {{[-w|-width]}} {{width}} {{[-h|-height]}} {{height}} {{color1 color2 ...}} > {{path/to/output_file.ppm}}`
 
 - End the rainbow with the last color specified, do not repeat the first color:
 
-`ppmrainbow -norepeat {{color1 color2 ...}} > {{path/to/output_file.ppm}}`
+`ppmrainbow {{[-n|-norepeat]}} {{color1 color2 ...}} > {{path/to/output_file.ppm}}`

pages/common/ppmspread.md

@@ -9,4 +9,4 @@
 
 - Specify a seed to a the pseudo-random number generator:
 
-`ppmspread {{a}} {{path/to/input_file.ppm}} -randomseed {{seed}} > {{path/to/output_file.ppm}}`
+`ppmspread {{a}} {{path/to/input_file.ppm}} {{[-r|-randomseed]}} {{seed}} > {{path/to/output_file.ppm}}`

pages/common/ppmtoacad.md

@@ -9,7 +9,7 @@
 
 - Convert a PPM image to an AutoCAD binary database import file:
 
-`ppmtoacad -dxb {{path/to/file.ppm}} > {{path/to/file.dxb}}`
+`ppmtoacad {{[-d|-dxb]}} {{path/to/file.ppm}} > {{path/to/file.dxb}}`
 
 - Restrict the colors in the output to 8 RGB shades:
 

pages/common/ppmtoarbtxt.md

@@ -17,4 +17,4 @@
 
 - Display version:
 
-`ppmtoarbtxt -version`
+`ppmtoarbtxt {{[-v|-version]}}`

pages/common/ppmtobmp.md

@@ -13,4 +13,4 @@
 
 - Use a specific number of bits for each pixel:
 
-`ppmtobmp -bbp {{1|4|8|24}} {{path/to/file.ppm}} > {{path/to/file.bmp}}`
+`ppmtobmp {{[-b|-bbp]}} {{1|4|8|24}} {{path/to/file.ppm}} > {{path/to/file.bmp}}`

pages/common/ppmtoicr.md

@@ -9,12 +9,12 @@
 
 - Display the output in name:
 
-`ppmtoicr -windowname {{name}} {{path/to/file.ppm}} > {{path/to/file.icr}}`
+`ppmtoicr {{[-w|-windowname]}} {{name}} {{path/to/file.ppm}} > {{path/to/file.icr}}`
 
 - Expand the image by the specified factor:
 
-`ppmtoicr -expand {{factor}} {{path/to/file.ppm}} > {{path/to/file.icr}}`
+`ppmtoicr {{[-e|-expand]}} {{factor}} {{path/to/file.ppm}} > {{path/to/file.icr}}`
 
 - Display the output on the screen with the specified number:
 
-`ppmtoicr -display {{number}} {{path/to/file.ppm}} > {{path/to/file.icr}}`
+`ppmtoicr {{[-d|-display]}} {{number}} {{path/to/file.ppm}} > {{path/to/file.icr}}`

pages/common/ppmtoilbm.md

@@ -9,11 +9,11 @@
 
 - Write a maximum of n planes to the ILBM file and produce a HAM/24bit/direct color file if this number is exceeded:
 
-`ppmtoilbm -maxplanes {{n}} -{{hamif|24if|dcif}} {{path/to/file.ppm}} > {{path/to/file.ilbm}}`
+`ppmtoilbm {{[-mp|-maxplanes]}} {{n}} -{{hamif|24if|dcif}} {{path/to/file.ppm}} > {{path/to/file.ilbm}}`
 
 - Produce a ILBM file with exactly n planes:
 
-`ppmtoilbm -fixplanes {{n}} {{path/to/file.ppm}} > {{path/to/file.ilbm}}`
+`ppmtoilbm {{[-fp|-fixplanes]}} {{n}} {{path/to/file.ppm}} > {{path/to/file.ilbm}}`
 
 - Select the compression method to be used:
 

pages/common/ppmtolj.md

@@ -9,8 +9,8 @@
 
 - Apply a gamma correction using the specified gamma value:
 
-`ppmtolj -gamma {{gamma}} {{path/to/input.ppm}} > {{path/to/output.lj}}`
+`ppmtolj {{[-g|-gamma]}} {{gamma}} {{path/to/input.ppm}} > {{path/to/output.lj}}`
 
 - Specify the required resolution:
 
-`ppmtolj -resolution {{75|100|150|300|600}} {{path/to/input.ppm}} > {{path/to/output.lj}}`
+`ppmtolj {{[-r|-resolution]}} {{75|100|150|300|600}} {{path/to/input.ppm}} > {{path/to/output.lj}}`

pages/common/ppmtomitsu.md

@@ -9,8 +9,8 @@
 
 - Enlarge the image by the specified factor, use the specified sharpness and produce `n` copies:
 
-`ppmtomitsu -enlarge {{1|2|3}} -sharpness {{1|2|3|4}} -copy {{n}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`
+`ppmtomitsu {{[-e|-enlarge]}} {{1|2|3}} {{[-s|-sharpness]}} {{1|2|3|4}} {{[-c|-copy]}} {{n}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`
 
 - Use the given medium for the printing process:
 
-`ppmtomitsu -media {{A|A4|AS|A4S}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`
+`ppmtomitsu {{[-m|-media]}} {{A|A4|AS|A4S}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`

pages/common/ppmtompeg.md

@@ -9,11 +9,11 @@
 
 - Encode the GOP with the specified number only:
 
-`ppmtompeg -gop {{gop_num}} {{path/to/parameter_file}}`
+`ppmtompeg {{[-g|-gop]}} {{gop_num}} {{path/to/parameter_file}}`
 
 - Specify the first and last frame to encode:
 
-`ppmtompeg -frames {{first_frame}} {{last_frame}} {{path/to/parameter_file}}`
+`ppmtompeg {{[-fr|-frames]}} {{first_frame}} {{last_frame}} {{path/to/parameter_file}}`
 
 - Combine multiple MPEG frames into a single MPEG-1 stream:
 

pages/common/ppmtopgm.md

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

pages/common/ppmtopj.md

@@ -9,8 +9,8 @@
 
 - Move the image in the x and y direction:
 
-`ppmtopj -xpos {{dx}} -ypos {{dy}} {{path/to/input.ppm}} > {{path/to/output.pj}}`
+`ppmtopj {{[-x|-xpos]}} {{dx}} {{[-y|-ypos]}} {{dy}} {{path/to/input.ppm}} > {{path/to/output.pj}}`
 
 - Explicitly specify a gamma value:
 
-`ppmtopj -gamma {{gamma}} {{path/to/input.ppm}} > {{path/to/output.pj}}`
+`ppmtopj {{[-g|-gamma]}} {{gamma}} {{path/to/input.ppm}} > {{path/to/output.pj}}`

pages/common/ppmtopjxl.md

@@ -9,12 +9,12 @@
 
 - Resize the input image:
 
-`ppmtopjxl -xsize {{10cm}} -ysize {{5cm}} {{path/to/image.ppm}} > {{path/to/output.pjxl}}`
+`ppmtopjxl {{[-xsi|-xsize]}} {{10cm}} {{[-ysi|-ysize]}} {{5cm}} {{path/to/image.ppm}} > {{path/to/output.pjxl}}`
 
 - Shift the input image:
 
-`ppmtopjxl -xshift {{10pt}} -yshift {{5pt}} {{path/to/image.ppm}} > {{path/to/output.pjxl}}`
+`ppmtopjxl {{[-xsh|-xshift]}} {{10pt}} {{[-ysh|-yshift]}} {{5pt}} {{path/to/image.ppm}} > {{path/to/output.pjxl}}`
 
 - Do not use the normal TIFF 4.0 compression method:
 
-`ppmtopjxl -nopack {{path/to/image.ppm}} > {{path/to/output.pjxl}}`
+`ppmtopjxl {{[-n|-nopack]}} {{path/to/image.ppm}} > {{path/to/output.pjxl}}`

pages/common/ppmtoppm.md

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

pages/common/ppmtosixel.md

@@ -9,11 +9,11 @@
 
 - Produce an uncompressed SIXEL file that is much slower to print:
 
-`ppmtosixel -raw {{path/to/file.ppm}} > {{path/to/file.sixel}}`
+`ppmtosixel {{[-r|-raw]}} {{path/to/file.ppm}} > {{path/to/file.sixel}}`
 
 - Add a left margin of 1.5 inches:
 
-`ppmtosixel -margin {{path/to/file.ppm}} > {{path/to/file.sixel}}`
+`ppmtosixel {{[-m|-margin]}} {{path/to/file.ppm}} > {{path/to/file.sixel}}`
 
 - Encode control codes in a more portable (although less space-efficient) way:
 

pages/common/ppmtoxpm.md

@@ -9,12 +9,12 @@
 
 - Specify the prefix string in the output XPM image:
 
-`ppmtoxpm -name {{prefix_string}} {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`
+`ppmtoxpm {{[-n|-name]}} {{prefix_string}} {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`
 
 - In the output XPM file, specify colors by their hexadecimal code instead of their name:
 
-`ppmtoxpm -hexonly {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`
+`ppmtoxpm {{[-h|-hexonly]}} {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`
 
 - Use the specified PGM file as a transparency mask:
 
-`ppmtoxpm -alphamask {{path/to/alpha_file.pgm}} {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`
+`ppmtoxpm {{[-a|-alphamask]}} {{path/to/alpha_file.pgm}} {{path/to/input_file.ppm}} > {{path/to/output_file.xpm}}`

pages/common/ppmtv.md

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

pages/common/ppmwheel.md

@@ -9,8 +9,8 @@
 
 - Generate a color wheel of type `Hue-value`:
 
-`ppmwheel -huevalue {{diameter}} > {{path/to/output.ppm}}`
+`ppmwheel {{[-huev|-huevalue]}} {{diameter}} > {{path/to/output.ppm}}`
 
 - Generate a color wheel of type `Hue-saturation`:
 
-`ppmwheel -huesaturation {{diameter}} > {{path/to/output.ppm}}`
+`ppmwheel {{[-hues|-huesaturation]}} {{diameter}} > {{path/to/output.ppm}}`

pages/common/rawtoppm.md

@@ -9,15 +9,15 @@
 
 - Convert a raw RGB stream in which the pixels come bottom-first instead of top-first to a PPM image:
 
-`rawtoppm {{width}} {{height}} {{path/to/image.raw}} | pamflip -tb > {{path/to/output.ppm}}`
+`rawtoppm {{width}} {{height}} {{path/to/image.raw}} | pamflip {{[-tb|-topbottom]}} > {{path/to/output.ppm}}`
 
 - Ignore the first n bytes of the specified file:
 
-`rawtoppm {{width}} {{height}} -headerskip {{n}} {{path/to/image.raw}} > {{path/to/output.ppm}}`
+`rawtoppm {{width}} {{height}} {{[-h|-headerskip]}} {{n}} {{path/to/image.raw}} > {{path/to/output.ppm}}`
 
 - Ignore the last m bytes of each row in the specified file:
 
-`rawtoppm {{width}} {{height}} -rowskip {{m}} {{path/to/image.raw}} > {{path/to/output.ppm}}`
+`rawtoppm {{width}} {{height}} {{[-ro|-rowskip]}} {{m}} {{path/to/image.raw}} > {{path/to/output.ppm}}`
 
 - Specify the order of color components for each pixel:
 

pages/common/sldtoppm.md

@@ -9,4 +9,4 @@
 
 - Compensate for non-square pixels by scaling the width of the image:
 
-`sldtoppm -adjust {{path/to/input.sld}} > {{path/to/output.ppm}}`
+`sldtoppm {{[-a|-adjust]}} {{path/to/input.sld}} > {{path/to/output.ppm}}`

pages/common/svgtopam.md

@@ -9,4 +9,4 @@
 
 - Emit textual output describing the input image:
 
-`svgtopam -trace {{path/to/file.svg}}`
+`svgtopam {{[-t|-trace]}} {{path/to/file.svg}}`

pages/common/tgatoppm.md

@@ -9,12 +9,12 @@
 
 - Dump information from the TGA header to `stdout`:
 
-`tgatoppm --headerdump {{path/to/file.tga}} > {{path/to/output.ppm}}`
+`tgatoppm {{[-h|-headerdump]}} {{path/to/file.tga}} > {{path/to/output.ppm}}`
 
 - Write the transparency channel values of the input image to the specified file:
 
-`tgatoppm --alphaout {{path/to/transparency_file.pgm}} {{path/to/file.tga}} > {{path/to/output.ppm}}`
+`tgatoppm {{[-a|-alphaout]}} {{path/to/transparency_file.pgm}} {{path/to/file.tga}} > {{path/to/output.ppm}}`
 
 - Display version:
 
-`tgatoppm -version`
+`tgatoppm {{[-v|-version]}}`

pages/common/ximtoppm.md

@@ -9,4 +9,4 @@
 
 - Store the transparency mask of the input image in the specified file:
 
-`ximtoppm --alphaout {{path/to/alpha_file.pbm}} {{path/to/input_file.xim}} > {{path/to/output_file.ppm}}`
+`ximtoppm {{[-a|-alphaout]}} {{path/to/alpha_file.pbm}} {{path/to/input_file.xim}} > {{path/to/output_file.ppm}}`

pages/common/xpmtoppm.md

@@ -9,4 +9,4 @@
 
 - Store the transparency mask of the input image in the specified file:
 
-`xpmtoppm --alphaout {{path/to/alpha_file.pbm}} {{path/to/input_file.xpm}} > {{path/to/output_file.ppm}}`
+`xpmtoppm {{[-a|--alphaout]}} {{path/to/alpha_file.pbm}} {{path/to/input_file.xpm}} > {{path/to/output_file.ppm}}`

pages/common/yuy2topam.md

@@ -5,4 +5,4 @@
 
 - Convert YUY2 bytes to PAM:
 
-`yuy2topam -width {{value}} -height {{value}} {{path/to/file.yuy2}} > {{path/to/file.pam}}`
+`yuy2topam {{[-w|-width]}} {{value}} {{[-h|-height]}} {{value}} {{path/to/file.yuy2}} > {{path/to/file.pam}}`