• Paolo Bonzini's avatar
    docs/system: convert Texinfo documentation to rST · 324b2298
    Paolo Bonzini authored
    Apart from targets.rst, which was written by hand, this is an automated
    conversion obtained with the following command:
    
      makeinfo --force -o - --docbook \
        -D 'qemu_system_x86 QEMU_SYSTEM_X86_MACRO' \
        -D 'qemu_system     QEMU_SYSTEM_MACRO' \
        $texi | pandoc -f docbook -t rst+smart | perl -e '
          $/=undef;
          $_ = <>;
          s/^-  − /-  /gm;
          s/QEMU_SYSTEM_MACRO/|qemu_system|/g;
          s/QEMU_SYSTEM_X86_MACRO/|qemu_system_x86|/g;
          s/(?=::\n\n +\|qemu)/.. parsed-literal/g;
          s/:\n\n::$/::/gm;
          print' > $rst
    
    In addition, the following changes were made manually:
    
    - target-i386.rst and target-mips.rst: replace CPU model documentation with
      an include directive
    
    - monitor.rst: replace the command section with a comment
    
    - images.rst: add toctree
    
    - target-arm.rst: Replace use of :math: (which Sphinx complains
      about) with :sup:, and hide it behind |I2C| and |I2C| substitutions.
    
    Content that is not @included remains exclu...
    324b2298
linuxboot.rst 944 Bytes