Multiple
========

Arithmetic functions
^^^^^^^^^^^^^^^^^^^^

.. function:: _Decimal32 __dpd_addsd3 (_Decimal32 a, _Decimal32 b)
              _Decimal32 __bid_addsd3 (_Decimal32 a, _Decimal32 b)
              _Decimal64 __dpd_adddd3 (_Decimal64 a, _Decimal64 b)
              _Decimal64 __bid_adddd3 (_Decimal64 a, _Decimal64 b)
              _Decimal128 __dpd_addtd3 (_Decimal128 a, _Decimal128 b)
              _Decimal128 __bid_addtd3 (_Decimal128 a, _Decimal128 b)

  These functions return the sum of :samp:`{a}` and :samp:`{b}`.

Names:
^^^^^^

* git
* SSH
* FooBar (all versions)

    Install these requirements.

Tools/packages necessary for building GCC
=========================================

* autoconf version 2.69
* GNU m4 version 1.4.6 (or later)

  Necessary when modifying :samp:`configure.ac`, :samp:`aclocal.m4`, etc.
  to regenerate :samp:`configure` and :samp:`config.in` files.

git (any version)
SSH (any version)
Foobar (all versions)

  Necessary to access the source repository.  Public releases and weekly
  snapshots of the development sources are also available via HTTPS.

.. option:: -mmmx
            -msse
            -msse2

  These switches enable the use of instructions in the MMX, SSE,
  SSE2, ... 

Use these options: :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3` :option:`-Wno-shift-overflow3`.

Code block:

.. code-block::

  gcc a.c
  ./a.out

And then there's a note:

.. note::

   I am a note!

And then there's something else.

Listing:

:samp:`{file}.cc` :samp:`{file}.cp` :samp:`{file}.cxx` :samp:`{file}.cpp` :samp:`{file}.CPP` :samp:`{file}.c++` :samp:`{file}.C`
  C++ source code that must be preprocessed.  Note that in :samp:`.cxx`,
  the last two letters must both be literally :samp:`x`.  Likewise,
  :samp:`.C` refers to a literal capital C.

:samp:`{file}.mm` :samp:`{file}.M`
  Objective-C++ source code that must be preprocessed.

:samp:`{file}.mii`
  Objective-C++ source code that should not be preprocessed.

:samp:`{file}.hh` :samp:`{file}.H` :samp:`{file}.hp` :samp:`{file}.hxx` :samp:`{file}.hpp` :samp:`{file}.HPP` :samp:`{file}.h++` :samp:`{file}.tcc`
  C++ header file to be turned into a precompiled header or Ada spec.

.. program:: make

.. option:: --verbose, -v

Use verbose mode.

.. program:: None

Use :option:`--verbose` mode.

This works: :option:`--verbose <make --verbose>` and :option:`--verbose <make -v>`.

.. function:: enum gimple_code gimple_code (gimple g)

  Return the code for statement ``G``.

.. option:: -o directory, --object-directory directory, --object-file file

  Test it.

.. option:: -foo={BAR}, -f {BAR} {BAZ}

  Using emphasising placeholders.

.. option:: -foo=BAR, -f BAR BAZ

   Normal option values.

   .. todo:: FIX this page properly

Formatting
==========

just a test to reference a :pr:`12345`.


.. todolist::