* [PATCH 0/3] Documentation: fix sphinx warnings
@ 2016-08-12 14:32 Antony Pavlov
2016-08-12 14:32 ` [PATCH 1/3] Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning Antony Pavlov
` (3 more replies)
0 siblings, 4 replies; 5+ messages in thread
From: Antony Pavlov @ 2016-08-12 14:32 UTC (permalink / raw)
To: barebox
Antony Pavlov (3):
Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning
Documentation: barebox: fix 'Could not lex literal_block as "c"' warning
Documentation: variables: fix error in "code-block" directive
Documentation/boards/mips/tplink-mr3020.rst | 12 ++++--
Documentation/user/barebox.rst | 60 +++++++++++++++++++++--------
Documentation/user/variables.rst | 1 +
3 files changed, 55 insertions(+), 18 deletions(-)
--
2.8.1
_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 1/3] Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning
2016-08-12 14:32 [PATCH 0/3] Documentation: fix sphinx warnings Antony Pavlov
@ 2016-08-12 14:32 ` Antony Pavlov
2016-08-12 14:32 ` [PATCH 2/3] Documentation: barebox: " Antony Pavlov
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: Antony Pavlov @ 2016-08-12 14:32 UTC (permalink / raw)
To: barebox
The patch fixes these sphinx warnings:
barebox/Documentation/boards/mips/tplink-mr3020.rst:31: WARNING: Could not lex literal_block as "c". Highlighting skipped.
barebox/Documentation/boards/mips/tplink-mr3020.rst:40: WARNING: Could not lex literal_block as "c". Highlighting skipped.
Signed-off-by: Antony Pavlov <antonynpavlov@gmail.com>
---
Documentation/boards/mips/tplink-mr3020.rst | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/Documentation/boards/mips/tplink-mr3020.rst b/Documentation/boards/mips/tplink-mr3020.rst
index 8a95e11..99101c3 100644
--- a/Documentation/boards/mips/tplink-mr3020.rst
+++ b/Documentation/boards/mips/tplink-mr3020.rst
@@ -26,7 +26,9 @@ The ``lzma`` utility can be obtained in Debian/Ubuntu
distro by installing lzma package
(lzma from xz-utils package is unusable).
-The ``mktplinkfw`` utility can be obtained from openwrt, e.g.::
+The ``mktplinkfw`` utility can be obtained from openwrt, e.g.:
+
+.. code-block:: sh
$ OWRTPREF=https://raw.githubusercontent.com/mirrors/openwrt/master
$ curl -OL $OWRTPREF/tools/firmware-utils/src/mktplinkfw.c \
@@ -35,7 +37,9 @@ The ``mktplinkfw`` utility can be obtained from openwrt, e.g.::
$ cc -o mktplinkfw mktplinkfw.c md5.c
To convert your barebox.bin to U-Boot-loadable image (``6F01A8C0.img``)
-use this command sequence::
+use this command sequence:
+
+.. code-block:: sh
$ lzma -c -k barebox-flash-image > barebox.lzma
$ ./mktplinkfw -c -H 0x07200103 -W 1 -N TL-WR720N-v3 \
@@ -47,7 +51,9 @@ Put your ``6F01A8C0.img`` to tftp-server directory
Connect your board to your tftp-server network via Ethernet.
-Next, setup network on MR3020 and run ``6F01A8C0.img``, e.g.::
+Next, setup network on MR3020 and run ``6F01A8C0.img``, e.g.:
+
+.. code-block:: console
hornet> set ipaddr 192.168.0.2
hornet> set serverip 192.168.0.1
--
2.8.1
_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 2/3] Documentation: barebox: fix 'Could not lex literal_block as "c"' warning
2016-08-12 14:32 [PATCH 0/3] Documentation: fix sphinx warnings Antony Pavlov
2016-08-12 14:32 ` [PATCH 1/3] Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning Antony Pavlov
@ 2016-08-12 14:32 ` Antony Pavlov
2016-08-12 14:32 ` [PATCH 3/3] Documentation: variables: fix error in "code-block" directive Antony Pavlov
2016-08-15 9:17 ` [PATCH 0/3] Documentation: fix sphinx warnings Sascha Hauer
3 siblings, 0 replies; 5+ messages in thread
From: Antony Pavlov @ 2016-08-12 14:32 UTC (permalink / raw)
To: barebox
The patch fixes these sphinx warnings:
barebox/Documentation/user/barebox.rst:19: WARNING: Could not lex literal_block as "c". Highlighting skipped.
barebox/Documentation/user/barebox.rst:33: WARNING: Could not lex literal_block as "c". Highlighting skipped.
barebox/Documentation/user/barebox.rst:186: WARNING: Could not lex literal_block as "c". Highlighting skipped.
barebox/Documentation/user/barebox.rst:205: WARNING: Could not lex literal_block as "c". Highlighting skipped.
Signed-off-by: Antony Pavlov <antonynpavlov@gmail.com>
---
Documentation/user/barebox.rst | 60 +++++++++++++++++++++++++++++++-----------
1 file changed, 45 insertions(+), 15 deletions(-)
diff --git a/Documentation/user/barebox.rst b/Documentation/user/barebox.rst
index 530693d..32cec3d 100644
--- a/Documentation/user/barebox.rst
+++ b/Documentation/user/barebox.rst
@@ -14,7 +14,9 @@ All releases can be downloaded from:
http://www.barebox.org/download/
Development versions of barebox are accessible via Git. A local repository clone
-can be checked out as follows::
+can be checked out as follows:
+
+.. code-block:: sh
$ git clone git://git.pengutronix.de/git/barebox.git
Cloning into 'barebox'...
@@ -28,7 +30,9 @@ can be checked out as follows::
After this, make sure to check out the appropriate branch. If you want to
develop for barebox, it's best to check out the ``next`` branch rather than
-the ``master`` branch::
+the ``master`` branch:
+
+.. code-block:: sh
$ git checkout -b next origin/remotes/next
@@ -59,13 +63,17 @@ variable. Currently, ``ARCH`` must be one of:
either contain the full path or, if the cross compiler binary is
in your $PATH, just the prefix.
-Either export ``ARCH`` and ``CROSS_COMPILE`` once before working on barebox::
+Either export ``ARCH`` and ``CROSS_COMPILE`` once before working on barebox:
+
+.. code-block:: sh
export ARCH=arm
export CROSS_COMPILE=/path/to/arm-cortexa8-linux-gnueabihf-
make ...
-or add them to each invocation of the ``make`` command::
+or add them to each invocation of the ``make`` command:
+
+.. code-block:: sh
ARCH=arm CROSS_COMPILE=/path/to/arm-cortexa8-linux-gnueabihf- make ...
@@ -76,17 +84,23 @@ Configuring for a board
All configuration files can be found under the ``arch/${ARCH}/configs/``
directory. For an overview of possible Make targets for your architecture,
-type::
+type:
+
+.. code-block:: sh
make help
Your output from ``make help`` will be based on the architecture you've
-selected via the ``ARCH`` variable. So if, for example, you had selected::
+selected via the ``ARCH`` variable. So if, for example, you had selected:
+
+.. code-block:: sh
export ARCH=mips
your help output would represent all of the generic (architecture-independent)
-targets, followed by the MIPS-specific ones::
+targets, followed by the MIPS-specific ones:
+
+.. code-block:: sh
make [ARCH=mips] help
...
@@ -104,12 +118,16 @@ targets, followed by the MIPS-specific ones::
barebox supports building for multiple boards with a single config. If you
can't find your board in the list, it may be supported by one of the multi-board
configs. As an example, this is the case for tegra_v7_defconfig and imx_v7_defconfig.
-Select your config with ``make <yourboard>_defconfig``::
+Select your config with ``make <yourboard>_defconfig``:
+
+.. code-block:: sh
make imx_v7_defconfig
The configuration can be further customized with one of the configuration frontends
-with the most popular being ``menuconfig``::
+with the most popular being ``menuconfig``:
+
+.. code-block:: sh
make menuconfig
@@ -127,7 +145,9 @@ generated in a separate build directory.
Once you check out your barebox source directory, and before you do any
configuration or building, set the environment variable ``KBUILD_OUTPUT``
-to point to your intended output directory, as in::
+to point to your intended output directory, as in:
+
+.. code-block:: sh
export KBUILD_OUTPUT=.../my_barebox_build_directory
@@ -150,14 +170,18 @@ Compilation
-----------
After barebox has been :ref:`configured <configuration>` it can be compiled
-simply with::
+simply with:
+
+.. code-block:: sh
make
The resulting binary varies depending on the board barebox is compiled for.
Without :ref:`multi_image` support the ``barebox-flash-image`` link will point
to the binary for flashing/uploading to the board. With :ref:`multi_image` support
-the compilation process will finish with a list of images built under ``images/``::
+the compilation process will finish with a list of images built under ``images/``:
+
+.. code-block:: sh
images built:
barebox-freescale-imx51-babbage.img
@@ -181,14 +205,18 @@ board documentation for initial bringup.
barebox binaries are, where possible, designed to be startable second stage from another
bootloader. For example, if you have U-Boot running on your board, you can start barebox
-with U-Boot's 'go' command::
+with U-Boot's 'go' command:
+
+.. code-block:: console
U-Boot: tftp $load_addr barebox.bin
U-Boot: go $load_addr
With barebox already running on your board, this can be used to chainload
another barebox. For instance, if you mounted a TFTP server to ``/mnt/tftp``
-(see :ref:`filesystems_tftp` for how to do that), chainload barebox with::
+(see :ref:`filesystems_tftp` for how to do that), chainload barebox with:
+
+.. code-block:: console
bootm /mnt/tftp/barebox.bin
@@ -200,7 +228,9 @@ stage.
First Steps
-----------
-This is a typical barebox startup log::
+This is a typical barebox startup log:
+
+.. code-block:: console
barebox 2014.06.0-00232-g689dc27-dirty #406 Wed Jun 18 00:25:17 CEST 2014
--
2.8.1
_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 3/3] Documentation: variables: fix error in "code-block" directive
2016-08-12 14:32 [PATCH 0/3] Documentation: fix sphinx warnings Antony Pavlov
2016-08-12 14:32 ` [PATCH 1/3] Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning Antony Pavlov
2016-08-12 14:32 ` [PATCH 2/3] Documentation: barebox: " Antony Pavlov
@ 2016-08-12 14:32 ` Antony Pavlov
2016-08-15 9:17 ` [PATCH 0/3] Documentation: fix sphinx warnings Sascha Hauer
3 siblings, 0 replies; 5+ messages in thread
From: Antony Pavlov @ 2016-08-12 14:32 UTC (permalink / raw)
To: barebox
The patch fixes this sphinx error:
barebox/Documentation/user/variables.rst:79: ERROR: Error in "code-block" directive:
maximum 1 argument(s) allowed, 15 supplied.
.. code-block:: sh
barebox@Phytec phyCARD-i.MX27:/ nv dev.nand0.partitions: 4M(barebox),1M(barebox-environment),-(root)
barebox@Phytec phyCARD-i.MX27:/ devinfo nand0
Parameters:
[...]
partitions: 4M(barebox),1M(barebox-environment),8M(kernel),1011M(root)
[...]
Signed-off-by: Antony Pavlov <antonynpavlov@gmail.com>
---
Documentation/user/variables.rst | 1 +
1 file changed, 1 insertion(+)
diff --git a/Documentation/user/variables.rst b/Documentation/user/variables.rst
index 89aadf5..e0a7941 100644
--- a/Documentation/user/variables.rst
+++ b/Documentation/user/variables.rst
@@ -77,6 +77,7 @@ to the corresponding <devname>.<paramname> variable.
This example changes the partitioning of the nand0 device:
.. code-block:: sh
+
barebox@Phytec phyCARD-i.MX27:/ nv dev.nand0.partitions: 4M(barebox),1M(barebox-environment),-(root)
barebox@Phytec phyCARD-i.MX27:/ devinfo nand0
Parameters:
--
2.8.1
_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 0/3] Documentation: fix sphinx warnings
2016-08-12 14:32 [PATCH 0/3] Documentation: fix sphinx warnings Antony Pavlov
` (2 preceding siblings ...)
2016-08-12 14:32 ` [PATCH 3/3] Documentation: variables: fix error in "code-block" directive Antony Pavlov
@ 2016-08-15 9:17 ` Sascha Hauer
3 siblings, 0 replies; 5+ messages in thread
From: Sascha Hauer @ 2016-08-15 9:17 UTC (permalink / raw)
To: Antony Pavlov; +Cc: barebox
On Fri, Aug 12, 2016 at 05:32:01PM +0300, Antony Pavlov wrote:
> Antony Pavlov (3):
> Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning
> Documentation: barebox: fix 'Could not lex literal_block as "c"' warning
> Documentation: variables: fix error in "code-block" directive
>
> Documentation/boards/mips/tplink-mr3020.rst | 12 ++++--
> Documentation/user/barebox.rst | 60 +++++++++++++++++++++--------
> Documentation/user/variables.rst | 1 +
> 3 files changed, 55 insertions(+), 18 deletions(-)
Applied, thanks
Sascha
--
Pengutronix e.K. | |
Industrial Linux Solutions | http://www.pengutronix.de/ |
Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |
_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2016-08-15 9:17 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-08-12 14:32 [PATCH 0/3] Documentation: fix sphinx warnings Antony Pavlov
2016-08-12 14:32 ` [PATCH 1/3] Documentation: tplink-mr3020: fix 'Could not lex literal_block as "c"' warning Antony Pavlov
2016-08-12 14:32 ` [PATCH 2/3] Documentation: barebox: " Antony Pavlov
2016-08-12 14:32 ` [PATCH 3/3] Documentation: variables: fix error in "code-block" directive Antony Pavlov
2016-08-15 9:17 ` [PATCH 0/3] Documentation: fix sphinx warnings Sascha Hauer
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox