Various docs improvements (#1925)

* Expose elf/* instead of just elf
* Remove rop/call, since it is not supposed to be a public API
* Make QEMU examples into code blocks

Author: heapcrash

docs/source/index.rst

@@ -52,7 +52,7 @@ Each of the ``pwntools`` modules is documented here.
    context
    dynelf
    encoders
-   elf
+   elf/*
    exception
    filepointer
    filesystem
@@ -65,7 +65,6 @@ Each of the ``pwntools`` modules is documented here.
    protocols
    qemu
    replacements
-   rop
    rop/*
    runner
    shellcraft
@@ -83,6 +82,7 @@ Each of the ``pwntools`` modules is documented here.
    :hidden:
 
    testexample
+   rop/call
 
 .. only:: not dash
 

docs/source/shellcraft/regsort.rst renamed to docs/source/regsort.rst

@@ -11,7 +11,7 @@
 In general, everything magic happens "behind the scenes", and pwntools
 attempts to make your life easier.
 
-When using :class:`.process.process`, pwntools will attempt to blindly
+When using :class:`.process`, pwntools will attempt to blindly
 execute the binary, in case your system is configured to use ``binfmt-misc``.
 
 If this fails, pwntools will attempt to manually launch the binary under
@@ -38,19 +38,19 @@
 architectures.
 
 First, install the QEMU emulator itself.  If your binary is statically-linked,
-thsi is sufficient.
+this is sufficient. ::
 
     $ sudo apt-get install qemu-user
 
 If your binary is dynamically linked, you need to install libraries like libc.
 Generally, this package is named ``libc6-$ARCH-cross``, e.g. ``libc-mips-cross``.
-ARM comes in both soft-float and hard-float variants, e.g. ``armhf``.
+ARM comes in both soft-float and hard-float variants, e.g. ``armhf``. ::
 
     $ sudo apt-get install libc6-arm64-cross
 
 If your binary relies on additional libraries, you can generally find them
 easily with ``apt-cache search``.  For example, if it's a C++ binary it
-may require ``libstdc++``.
+may require ``libstdc++``. ::
 
     $ apt-cache search 'libstdc++' | grep arm64
 
@@ -65,7 +65,7 @@
 If you try to run your library now, you'll probably see an error about ``libc.so.6`` missing.
 
 Create the ``/etc/qemu-binfmt`` directory if it does not exist, and create a symlink to
-the appropriate path.
+the appropriate path. ::
 
     $ sudo mkdir /etc/qemu-binfmt
     $ sudo ln -s /usr/aarch64-linux-gnu /etc/qemu-binfmt/aarch64