[Bug c/107653] New: how-to-use-inline-assembly-language-in-c-code page is huge and should be split up

pinskia at gcc dot gnu.org gcc-bugzilla@gcc.gnu.org
Fri Nov 11 21:22:41 GMT 2022


https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107653

            Bug ID: 107653
           Summary: how-to-use-inline-assembly-language-in-c-code page is
                    huge and should be split up
           Product: gcc
           Version: 13.0
            Status: UNCONFIRMED
          Keywords: documentation, inline-asm
          Severity: normal
          Priority: P3
         Component: c
          Assignee: unassigned at gcc dot gnu.org
          Reporter: pinskia at gcc dot gnu.org
  Target Milestone: ---

https://gcc.gnu.org/onlinedocs/gcc/extensions-to-the-c-language-family/how-to-use-inline-assembly-language-in-c-code.html
really needs to split up into many different pages.

Compared to
https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/Using-Assembly-Language-with-C.html#Using-Assembly-Language-with-C 

Having smaller pages is very useful, especially when you are going to just look
at target constraints (which was a huge page even for texinfo generated
documents):
https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/Machine-Constraints.html#Machine-Constraints

having all information on inline-asm on one page makes it hard to figure out
things even with the right side bar. The seperate pages of the texinfo
generated files makes it easier to navigate especially to the specific topic
you want to navigate to.  Having a TOC page for each section is very very
useful; the side bar only goes so far of describing things.


Note I have not double checked to make sure that the internals document and the
user manual are shared or not here plus disabling of some of the constraints
for the user manual either.


More information about the Gcc-bugs mailing list