#1100076 gcc-avr: Missing man page for "avr-gcc" command

Package:
gcc-avr
Source:
gcc-avr
Description:
GNU C compiler (cross compiler for avr)
Submitter:
R Philley
Date:
2025-03-11 06:09:01 UTC
Severity:
normal
#1100076#5
Date:
2025-03-11 03:22:33 UTC
From:
To:
Dear Maintainer,

   * What led up to the situation?

Needed to lookup options for the "avr-gcc" command. Could not find a man page.
As "gcc" has a companion package "gcc-doc", I looked for and could not find a
package "gcc-avr-doc". Tried the "gcc" man page, but it was not helpful due
different version levels.

avr-gcc --version:      avr-gcc (GCC) 5.4.0
gcc --version:          gcc (Debian 12.2.0-14) 12.2.0

Specifically, I was looking for program optimization options. Tried "-Oz" from
"gcc" man page, but it was not supported by "avr-gcc".

This leads me to humbly request that the man for "avr-gcc" be built into an
installable package. (Perhaps "gcc-avr-doc" ?)


Any attention to this issue would be appreciated. Thanks!
#1100076#10
Date:
2025-03-11 05:53:33 UTC
From:
To:
the latest if possible.

$ avr-gcc --version
avr-gcc (GCC) 14.2.0

$ avr-gcc --help=optimizers
The following options control optimizations:
  -O<number>                  Set optimization level to <number>.
  -Ofast                      Optimize for speed disregarding exact
standards compliance.
  -Og                         Optimize for debugging experience rather
than speed or size.
  -Os                         Optimize for space rather than speed.
  -Oz                         Optimize for space aggressively rather
than speed.
<...>

For a trivial example:
$ rm a.out
$ avr-gcc -mmcu=attiny1616 -Oz main.c
$ avr-size a.out
   text    data     bss     dec     hex filename
    210       0       0     210      d2 a.out

You may also wish to refer to /usr/share/doc/gcc-avr/README.Debian

Thanks
-Steve
#1100076#15
Date:
2025-03-11 05:53:33 UTC
From:
To:
the latest if possible.

$ avr-gcc --version
avr-gcc (GCC) 14.2.0

$ avr-gcc --help=optimizers
The following options control optimizations:
  -O<number>                  Set optimization level to <number>.
  -Ofast                      Optimize for speed disregarding exact
standards compliance.
  -Og                         Optimize for debugging experience rather
than speed or size.
  -Os                         Optimize for space rather than speed.
  -Oz                         Optimize for space aggressively rather
than speed.
<...>

For a trivial example:
$ rm a.out
$ avr-gcc -mmcu=attiny1616 -Oz main.c
$ avr-size a.out
   text    data     bss     dec     hex filename
    210       0       0     210      d2 a.out

You may also wish to refer to /usr/share/doc/gcc-avr/README.Debian

Thanks
-Steve