pdfjoin: refresh (#5787)

pages/common/pdfjoin.md

@@ -1,15 +1,20 @@
 # pdfjoin
 
-> PDF merging utility.
+> PDF merging utility based on pdfjam.
+> More information: <https://github.com/rrthomas/pdfjam-extras>.
 
-- Merge two PDFs:
+- Merge two PDFs into one with the default suffix "joined":
 
-`pdfjoin {{file1}} {{file2}} --outfile {{output_file}}`
+`pdfjoin {{path/to/file1.pdf}} {{path/to/file2.pdf}}`
 
-- Save pages 3 to 5 followed by page 1 to a new PDF:
+- Merge the first page of each given file together:
 
-`pdfjoin {{file 3-5,1}} --outfile {{output_file}}`
+`pdfjoin {{path/to/file1.pdf path/to/file2.pdf ...}} {{1}} --outfile {{output_file}}`
 
-- Merge subranges from two PDFs:
+- Save pages 3 to 5 followed by page 1 to a new PDF with custom suffix:
 
-`pdfjoin {{file1 3-5,1}} {{file2 4-6}} --outfile {{output_file}}`
+`pdfjoin {{path/to/file.pdf}} {{3-5,1}} --suffix {{rearranged}}`
+
+- Merge page subranges from two PDFs:
+
+`pdfjoin {/path/to/file1.pdf}} {{2-}} {{file2}} {{last-3}} --outfile {{output_file}}`