<!-- --------Before Creating a New Issue----------- * Limit report to a single issue. * Search the issue tracker to verify the issue has not already been reported. * Complete all instructions between `template comment markers <>. * Keep report contents limited to the necessary information required to fix the issue. * When creating an issue against the stable version of KiCad, make sure the latest available stable version is installed as issues may have already been resolved in later stable versions. --> # Description <!-- What is the current behavior and what is the expected behavior? --> <!-- If the issue is visual/graphical, please attach screenshots of the problem. --> <!-- Add the issue details below this line and before the "Steps to reproduce" heading. --> The `--output` argument for the command `kicad-cli pcb export gerbers` refers to an output directory. In the help text of `kicad-cli` it is documented as `[--output OUTPUT_FILE]`. The online documentation is also inconsistent, I've created a [separate ticket](https://gitlab.com/kicad/services/kicad-doc/-/issues/906) there. In my understanding, the `gerbers` command (with a trailing 's') does behave as intended, interpreting `--output` as a directory, into which multiple gerber files are exported. It's just incorrect documentation, that I guess might have been copied from the now deprecated `gerber` command (without the trailing 's'). # Steps to reproduce <!-- If there are multiple steps to reproduce it or it is a visual issue, then providing a screen recording as an attachment to this report is recommended. --> <!-- If this issue is specific to a project, please attach the necessary files to this issue. --> <!-- Add the steps to reproduce using the numbers below --> <!-- Add new step numbers before the "KiCad Version" heading. --> 1. View the helptext for `kicad-cli pcb export gerbers`. The argument `--output` is described in the summary as "OUTPUT_FILE" and in the details as "Output file". ``` $ kicad-cli pcb export gerbers --help input: 1 argument(s) expected. 0 provided. Usage: gerbers [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--precision PRECISION] [--no-protel-ext] [--plot-invisible-text] [--common-layers COMMON_LAYER_LIST] [--board-plot-params] INPUT_FILE Plot multiple Gerbers for a PCB, including the ability to use stored board plot settings Positional arguments: INPUT_FILE Input file Optional arguments: -h, --help Shows help message and exits -o, --output Output file [nargs=0..1] [default: ""] (...) ``` 2. Run `kicad-cli pcb export gerbers` with the `--output` argument on any .kicad_pcb file. It will interpret the `--output` parameter as a directory and create it if necessary. ``` $ kicad-cli pcb export gerbers gerbers-export.kicad_pcb --output test Plotted to 'test/gerbers-export-F_Cu.gtl'. Plotted to 'test/gerbers-export-B_Cu.gbl'. Plotted to 'test/gerbers-export-F_Adhesive.gta'. Plotted to 'test/gerbers-export-B_Adhesive.gba'. Plotted to 'test/gerbers-export-F_Paste.gtp'. Plotted to 'test/gerbers-export-B_Paste.gbp'. Plotted to 'test/gerbers-export-F_Silkscreen.gto'. Plotted to 'test/gerbers-export-B_Silkscreen.gbo'. Plotted to 'test/gerbers-export-F_Mask.gts'. Plotted to 'test/gerbers-export-B_Mask.gbs'. Plotted to 'test/gerbers-export-User_Drawings.gbr'. Plotted to 'test/gerbers-export-User_Comments.gbr'. Plotted to 'test/gerbers-export-User_Eco1.gbr'. Plotted to 'test/gerbers-export-User_Eco2.gbr'. Plotted to 'test/gerbers-export-Edge_Cuts.gm1'. Plotted to 'test/gerbers-export-Margin.gbr'. Plotted to 'test/gerbers-export-F_Courtyard.gbr'. Plotted to 'test/gerbers-export-B_Courtyard.gbr'. Plotted to 'test/gerbers-export-F_Fab.gbr'. Plotted to 'test/gerbers-export-B_Fab.gbr'. Plotted to 'test/gerbers-export-User_1.gbr'. Plotted to 'test/gerbers-export-User_2.gbr'. Plotted to 'test/gerbers-export-User_3.gbr'. Plotted to 'test/gerbers-export-User_4.gbr'. ``` # KiCad Version <!-- Copy version information (from main menu Help->About KiCad ->Copy Version Info) and paste it between the triple backticks below to preserve the formatting. --> ``` $ kicad-cli version --format about Application: kicad-cli x86_64 on x86_64 Version: 9.0.0-9.0.0-2~ubuntu22.04.1, release build Libraries: wxWidgets 3.2.1 FreeType 2.11.1 HarfBuzz 2.7.4 FontConfig 2.13.1 libcurl/7.81.0 OpenSSL/3.0.2 zlib/1.2.11 brotli/1.0.9 zstd/1.4.8 libidn2/2.3.2 libpsl/0.21.0 (+libidn2/2.3.2) libssh/0.9.6/openssl/zlib nghttp2/1.43.0 librtmp/2.3 OpenLDAP/2.5.18 Platform: Ubuntu 22.04.5 LTS, 64 bit, Little endian, wxBase, ubuntu, wayland Build Info: Date: Feb 20 2025 21:18:04 wxWidgets: 3.2.1 (wchar_t,wx containers) GTK+ 0.0 Boost: 1.74.0 OCC: 7.5.1 Curl: 7.81.0 ngspice: 43 Compiler: GCC 11.4.0 with C++ ABI 1016 KICAD_IPC_API=ON Locale: Lang: de_DE Enc: UTF-8 Num: 1.234,5 Encoded кΩ丈: D0BACEA9E4B888 (sys), D0BACEA9E4B888 (utf8) ```