Description: Extend ghdl.1 manpage
 Add the Debian specific ghdl alternatives information to the manpage.
Author: Andreas Bombe <aeb@debian.org>
Forwarded: not-needed
Last-Update: 2026-05-09
---
This patch header follows DEP-3: http://dep.debian.net/deps/dep3/
--- a/doc/ghdl.1
+++ b/doc/ghdl.1
@@ -14,13 +14,22 @@
 .\" .br        insert line break
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
-.TH "GHDL" "1" "Jun 24, 2006" "" ""
+.TH "GHDL" "1" "May 9, 2026" "" ""
 .SH "NAME"
 ghdl \- VHDL compiler/simulator
 .SH "SYNOPSIS"
 .B ghdl
 .RI [ command ] " " [ options ] " files" ...
 .br 
+.B ghdl-gcc
+.RI [ command ] " " [ options ] " files" ...
+.br 
+.B ghdl-llvm
+.RI [ command ] " " [ options ] " files" ...
+.br 
+.B ghdl-mcode
+.RI [ command ] " " [ options ] " files" ...
+.br 
 .SH "DESCRIPTION"
 This manual page documents briefly the
 .B ghdl
@@ -29,6 +38,13 @@
 reference documentation.
 .PP 
 Instead, users should read the GHDL texinfo manual
+.PP
+The Debian package supports installing multiple GHDL backends at the same time.
+These are then available under their own names as \fBghdl-gcc\fR,
+\fBghdl-llvm\fR or \fBghdl-mcode\fR.
+\fBghdl\fR is symlinked to a default backend.
+If you have multiple backends installed and would like to change the default, run
+\fIsudo update-alternatives --config ghdl\fR.
 .SH "OPTIONS"
 This program follows the usual GNU command line syntax, with long
 options starting with two dashes (`\-').
