Applied this patch that fix overly long URLs in the printed PDF
documentation.
They are useless since they overflow the page boundaries by quite
some margin. The links are still active in the PDF and HTML docs.
Johann
--
AVR: Fix overly long URLs in the printed PDF documentation
...that are useless since they overflow the page boundaries
by quite some margin.
gcc/
* doc/invoke.texi (AVR Options): Fix overly long URLs.
* doc/extend.texi (Specifying the size of an asm on AVR): Dito.
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 5e14f0cf523..48f10feb8af 100644
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -13504,8 +13504,8 @@ The following rules apply:
@itemize
@item All such annotations will be ignored with option
-@ref{avr_masm_len_notes,@option{-mno-asm-len-notes}}. Diagnosing can be
-adjusted with option @ref{avr_Wasm_len_notes,@option{-Wasm-len-notes}}.
+@ref{avr_masm_len_notes,,@option{-mno-asm-len-notes}}. Diagnosing can be
+adjusted with option @ref{avr_Wasm_len_notes,,@option{-Wasm-len-notes}}.
@item The length of the @code{asm} is the sum over all
@code{[[len=@var{spec}]]} notes in the @code{asm} template. When an invalid
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 09321ca5da9..6ae5a3db0cc 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -24300,11 +24300,11 @@ The following AVR devices and ISAs are supported.
@emph{Note:} A complete device support consists of
startup code @code{crt@var{mcu}.o}, a device header @code{avr/io*.h},
a device library @code{lib@var{mcu}.a} and a
-@uref{https://gcc.gnu.org/wiki/avr-gcc#spec-files,device-specs} file
+@uref{https://gcc.gnu.org/wiki/avr-gcc#spec-files,,device-specs} file
@code{specs-@var{mcu}}. Only the latter is provided by the compiler
according the supported @code{@var{mcu}}s below. The rest is supported
-by @w{@uref{https://github.com/avrdudes/avr-libc/,AVR-LibC}}, or by means of
-@uref{https://gcc.gnu.org/wiki/avr-gcc#atpack,@code{atpack}} files
+by @w{@uref{https://github.com/avrdudes/avr-libc/,,AVR-LibC}}, or by means of
+@uref{https://gcc.gnu.org/wiki/avr-gcc#atpack,,@code{atpack}} files
from the hardware manufacturer.
@c Auto-generated. Re-build when new devices are added to avr-mcus.def
@@ -24325,7 +24325,7 @@ ATtiny40. See also the @code{absdata}
@itemx -mno-asm-len-notes
Recognize resp.@: ignore @code{[[len=@var{spec}]]} notes that are placed in
(comments in) inline assembly code templates. They allow to specify
-the exact @ref{Size of an asm,size of @code{asm} constructs}.
+the exact @ref{Size of an asm,,size of @code{asm} constructs}.
This option is on per default.
@opindex mcvt
@@ -24343,7 +24343,7 @@ code is no more pulled in from @code{lib@var{mcu}.a}.
For example, you can link with @code{-Wl,--defsym,__init_cvt=0}.
The CVT startup code is available since
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/1010,AVR-LibC v2.3}}.
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/1010,,AVR-LibC v2.3}}.
@opindex mdouble
@opindex mlong-double
@@ -24353,7 +24353,7 @@ Set the size (in bits) of the @code{double} or @code{long double} type,
respectively. Possible values for @var{bits} are 32 and 64.
Whether or not a specific value for @var{bits} is allowed depends on
the @code{--with-double=} and @code{--with-long-double=}
-@w{@uref{https://gcc.gnu.org/install/configure.html#avr,configure options}},
+@w{@uref{https://gcc.gnu.org/install/configure.html#avr,,configure options}},
and the same applies for the default values of the options.
@opindex mgas-isr-prologues
@@ -24364,7 +24364,7 @@ If this option is on, the feature can still be disabled for individual
ISRs by means of the @ref{AVR Attributes,,@code{no_gccisr}}
function attribute. This feature is activated per default
if optimization is on (but not with @option{-Og}, @pxref{Optimize Options}),
-and if GNU Binutils support @w{@uref{https://sourceware.org/PR21683,PR21683}}.
+and if GNU Binutils support @w{@uref{https://sourceware.org/PR21683,,PR21683}}.
@opindex mint8
@item -mint8
@@ -24389,13 +24389,13 @@ XCALL main
XJMP exit
@end example
Instead, put @code{main} in section
-@w{@uref{https://avrdudes.github.io/avr-libc/avr-libc-user-manual/mem_sections.html#sec_dot_init,@code{.init9}}}
+@w{@uref{https://avrdudes.github.io/avr-libc/avr-libc-user-manual/mem_sections.html#sec_dot_init,,@code{.init9}}}
so that no call is required.
By setting this option the user asserts that @code{main} will not return.
This option can be used for devices with very limited resources in order
to save a few bytes of code and stack space. It will work as expected since
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/1012,AVR-LibC v2.3}}.
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/1012,,AVR-LibC v2.3}}.
With older versions, there will be no performance gain.
@opindex mno-interrupts
@@ -24434,7 +24434,7 @@ like an assertion.
Since v14 and for the AVR64* and AVR128* devices, @code{.rodata}
is located in flash memory per default, provided the required GNU Binutils
-support (@w{@uref{https://sourceware.org/PR31124,PR31124}}) is available.
+support (@w{@uref{https://sourceware.org/PR31124,,PR31124}}) is available.
In that case, @option{-mrodata-in-ram} can be used to return to the old
layout with @code{.rodata} in RAM.
@@ -24453,13 +24453,13 @@ Don't link against AVR-LibC's device specific library @code{lib@var{mcu}.a}.
Notice that since AVR-LibC v2.3, that library contains code that is
essential for the correct functioning of a program. In particular,
it contains parts of the startup code like:
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/1011,@code{__init_sp}}}
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/1011,,@code{__init_sp}}}
to initialize the stack pointer with symbol @code{__stack},
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/1010,@code{__init_cvt}}}
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/1010,,@code{__init_cvt}}}
to set up the hardware to use a compact vector table with @option{-mcvt},
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/1012,@code{__call_main}}}
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/1012,,@code{__call_main}}}
to call @code{main} and @code{exit}, and
-@w{@uref{https://github.com/avrdudes/avr-libc/issues/931,@code{__do_flmap_init}}}
+@w{@uref{https://github.com/avrdudes/avr-libc/issues/931,,@code{__do_flmap_init}}}
to set up FLMAP according to symbol @code{__flmap}.
@opindex nodevicespecs
@@ -24486,8 +24486,8 @@ resulting address space is not contained in the incoming address space.
@opindex Wasm-len-notes
@item -Wasm-len-notes
Warn about unrecognized @code{[[len=@var{spec}]]}
-@ref{Size of an asm,length} annotations in inline assembly code templates.
-This @ref{Warning Options,warning} is on per default.
+@ref{Size of an asm,,length} annotations in inline assembly code templates.
+This @ref{Warning Options,,warning} is on per default.
Notice that in LTO mode, the code must be compiled with option
@option{-ffat-lto-objects} in order for these diagnoses to appear.
@@ -24658,7 +24658,7 @@ points to.
The startup code from libgcc never sets @code{EIND}.
Notice that startup code is a blend of code from libgcc and AVR-LibC.
For the impact of AVR-LibC on @code{EIND}, see the
-@w{@uref{https://avrdudes.github.io/avr-libc/avr-libc-user-manual/,AVR-LibC user manual}}.
+@w{@uref{https://avrdudes.github.io/avr-libc/avr-libc-user-manual/,,AVR-LibC user manual}}.
@item
It is legitimate for user-specific startup code to set up @code{EIND}
@@ -24760,7 +24760,7 @@ The startup code initializes the @code{RAMP} special function
registers with zero.
@item
-If a @ref{AVR Named Address Spaces,named address space} other than
+If a @ref{AVR Named Address Spaces,,named address space} other than
generic or @code{__flash} is used, then @code{RAMPZ} is set
as needed before the operation.
@@ -24952,7 +24952,7 @@ This applies to the AVR64* and AVR128* devices.
@item It's not known at assembler-time which emulation will be used.
@end itemize
This implies the compiler was configured with GNU Binutils that implement
-@w{@uref{https://sourceware.org/PR31124,PR31124}}.
+@w{@uref{https://sourceware.org/PR31124,,PR31124}}.
@item __AVR_RODATA_IN_RAM__
This macro is undefined when the code is compiled for a core architecture.
@@ -24993,14 +24993,14 @@ Same as above, but for @code{long double} instead of @code{double}.
@item __WITH_DOUBLE_COMPARISON__
Reflects the @code{--with-double-comparison=@{tristate|bool|libf7@}}
-@w{@uref{https://gcc.gnu.org/install/configure.html#avr,configure option}}
+@w{@uref{https://gcc.gnu.org/install/configure.html#avr,,configure option}}
and is defined to @code{2} or @code{3}.
@item __WITH_LIBF7_LIBGCC__
@itemx __WITH_LIBF7_MATH__
@itemx __WITH_LIBF7_MATH_SYMBOLS__
Reflects the @code{--with-libf7=@{libgcc|math|math-symbols@}}
-@w{@uref{https://gcc.gnu.org/install/configure.html#avr,configure option}}.
+@w{@uref{https://gcc.gnu.org/install/configure.html#avr,,configure option}}.
@end table
@@ -25011,7 +25011,7 @@ options by hand, in particular they are not optimization options.
Using these options in the wrong way may lead to sub-optimal or wrong code.
They are documented for completeness, and in order to get a better
understanding of
-@w{@uref{https://gcc.gnu.org/wiki/avr-gcc#spec-files,device specs}}
+@w{@uref{https://gcc.gnu.org/wiki/avr-gcc#spec-files,,device specs}}
files.
@table @gcctabopt
