Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: ARC: Improve readability

There were some things which made rendered document
look not very elegant. That was because:

1. Numbered lists were formatted in more of Markdown way
rather than true reStructuredText and so were displayed
as a plain text with leading numbers.

Well, moreover numbered lists were not needed as in all cases
we were just listing a couple of options w/o any intention to
follow any particular order, so a simpler unordered list fits
better and looks cleaner.

2. URL's of external resources were added as they are
(which is OK in a plain text, but make not much sense in
a HTML where we may use more human-friendly link names
with URL's hidden.

3. Some URL's had trailing slashes which were not really needed

Fix all items from above!

Signed-off-by: Alexey Brodkin <abrodkin@synopsys.com>
Cc: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Vineet Gupta <vgupta@kernel.org>
Link: https://lore.kernel.org/r/20211202215747.19923-1-abrodkin@synopsys.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Alexey Brodkin and committed by
Jonathan Corbet
7ef5d754 a6fb8b5a

+31 -27
+31 -27
Documentation/arc/arc.rst
··· 9 9 Below are some resources where more information can be found on 10 10 ARC processors and relevant open source projects. 11 11 12 - 1. `<https://embarc.org/>`_ - Community portal for open source on ARC. 13 - Good place to start to find relevant FOSS projects, toolchain releases, 14 - news items and more. 12 + - `<https://embarc.org>`_ - Community portal for open source on ARC. 13 + Good place to start to find relevant FOSS projects, toolchain releases, 14 + news items and more. 15 15 16 - 2. `<https://github.com/foss-for-synopsys-dwc-arc-processors>`_ - 17 - Home for all development activities regarding open source projects for 18 - ARC processors. Some of the projects are forks of various upstream projects, 19 - where "work in progress" is hosted prior to submission to upstream projects. 20 - Other projects are developed by Synopsys and made available to community 21 - as open source for use on ARC Processors. 16 + - `<https://github.com/foss-for-synopsys-dwc-arc-processors>`_ - 17 + Home for all development activities regarding open source projects for 18 + ARC processors. Some of the projects are forks of various upstream projects, 19 + where "work in progress" is hosted prior to submission to upstream projects. 20 + Other projects are developed by Synopsys and made available to community 21 + as open source for use on ARC Processors. 22 22 23 - 3. `<https://www.synopsys.com/designware-ip/processor-solutions.html>`_ - 24 - Official Synopsys ARC Processors website location, with access to some IP 25 - documentation (Programmer's Reference Manuals, AKA "PRM's", see 26 - `<https://www.synopsys.com/dw/doc.php/ds/cc/programmers-reference-manual-ARC-HS.pdf>`_) 27 - and commercial tools (Free nSIM, 28 - `<https://www.synopsys.com/cgi-bin/dwarcnsim/req1.cgi>`_ and 29 - MetaWare Light Edition, `<https://www.synopsys.com/cgi-bin/arcmwtk_lite/reg1.cgi>`_) 23 + - `Official Synopsys ARC Processors website 24 + <https://www.synopsys.com/designware-ip/processor-solutions.html>`_ - 25 + location, with access to some IP documentation (`Programmer's Reference 26 + Manual, AKA PRM for ARC HS processors 27 + <https://www.synopsys.com/dw/doc.php/ds/cc/programmers-reference-manual-ARC-HS.pdf>`_) 28 + and free versions of some commercial tools (`Free nSIM 29 + <https://www.synopsys.com/cgi-bin/dwarcnsim/req1.cgi>`_ and 30 + `MetaWare Light Edition <https://www.synopsys.com/cgi-bin/arcmwtk_lite/reg1.cgi>`_). 31 + Please note though, registration is required to access both the documentation and 32 + the tools. 30 33 31 34 Important note on ARC processors configurability 32 35 ################################################ ··· 55 52 The process of kernel building for ARC processors is the same as for any other 56 53 architecture and could be done in 2 ways: 57 54 58 - 1. cross-compilation: process of compiling for ARC targets on a development 59 - host with a different processor architecture (generally x86_64/amd64). 60 - 61 - 2. native compilation: process of compiling for ARC on a ARC platform 62 - (hardware board or a simulator like QEMU) with complete development environment 63 - (GNU toolchain, dtc, make etc) installed on the platform. 55 + - Cross-compilation: process of compiling for ARC targets on a development 56 + host with a different processor architecture (generally x86_64/amd64). 57 + - Native compilation: process of compiling for ARC on a ARC platform 58 + (hardware board or a simulator like QEMU) with complete development environment 59 + (GNU toolchain, dtc, make etc) installed on the platform. 64 60 65 61 In both cases, up-to-date GNU toolchain for ARC for the host is needed. 66 62 Synopsys offers prebuilt toolchain releases which can be used for this purpose, 67 63 available from: 68 64 69 - 1. Synopsys GNU toolchain releases: 70 - `<https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases>`_ 71 - 2. Linux kernel compilers collection: 72 - `<https://mirrors.edge.kernel.org/pub/tools/crosstool/>`_ 73 - 3. Bootlin's toolchain collection: `<https://toolchains.bootlin.com/>`_ 65 + - Synopsys GNU toolchain releases: 66 + `<https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases>`_ 67 + 68 + - Linux kernel compilers collection: 69 + `<https://mirrors.edge.kernel.org/pub/tools/crosstool>`_ 70 + 71 + - Bootlin's toolchain collection: `<https://toolchains.bootlin.com>`_ 74 72 75 73 Once the toolchain is installed in the system, make sure its "bin" folder 76 74 is added in your ``PATH`` environment variable. Then set ``ARCH=arc`` &