This is the translation of LoongArch documentation.
The HTML versions are more readable than the PDF versions, not only because there exists tables of excessive length, but also because the theme of html versions is easier to customize. To make it easier to download, each HTML page contains embedded CSS and images.
-
LoongArch Reference Manual - Volume 1: Basic Architecture: This manual describes the basic part of the LoongArch architecture.
-
LoongArch Reference Manual - Volume 2: Vector Extensions: This manual describes the vector extensions (SIMD and Advanced SIMD Extensions) of the LoongArch architecture.
-
LoongArch Reference Manual - Volume 3: Virtualization and Binary Translation Extensions: This manual describes the virtualization and binary translation extensions of the LoongArch architecture.
-
Loongson 3A5000/3B5000 Registers Technical Reference Manual - Multicore Processor Architecture, Register Descriptions and System Software Programming Guide: This manual introduces the Loongson 3A5000/3B5000 multicore processor architecture and register descriptions.
-
Loongson 7A1000 Bridge User Manual: This manual describes the overall bridge architecture, clock structure, address space, configuration registers, and individual functional interfaces, primarily for BIOS and kernel developers.
-
LoongArch ELF ABI: This manual describes the LoongArch ELF ABI.
These documents were translated by Yanteng Si and Feiyang Chen.
Due to the limited knowledge of the translators, there are some inevitable errors and omissions existing in this document, please feel free to correct.
P.S. Since the academic level of the original authors is extraordinary high, words and phrases in the original documents are so profound that the translators with limited knowledge could not express them accurately even if they tried their best.
We strongly recommend that you develop on Linux/UNIX or macOS. If you want to develop on Windows, see Developing on Windows first.
-
Make sure the Ruby development environment is installed.
-
Install bunlder:
gem install bundler -
Clone this project:
git clone https://github.com/loongson/LoongArch-Documentation -
Enter the project repo and install the gems into the project using the bundle command (this will take a while, during which time about
20MBof data will be downloaded):cd LoongArch-Documentation && bundle config set --local path .bundle/gems && bundle -
Now you can generate the documents.
-
Convert AsciiDoc to both HTML and PDF:
bundle exec rake book:all -
Convert AsciiDoc to HTML only:
bundle exec rake book:html -
Convert AsciiDoc to PDF only:
bundle exec rake book:pdf -
Convert specified
book.adocto HTML:bundle exec rake book:html['book.adoc'] -
Convert specified
book.adocto PDF:bundle exec rake book:pdf['book.adoc']
-
-
Are there any prerequisites I need to take?
Install the environment refer to the Getting Start, and then see References for more information.
-
Why not use autogenerated section IDs?
Due to many duplicate titles, custom section IDs (
[[id]]) are better when being referenced (<<id,name>>). -
Why not use named HTML entities?
Asciidoctor PDF doesn’t support all named HTML entities (e.g.
×), so you have to use entity numbers (e.g.×) here. -
Are there any convenience tools?
See Golang AsciiDoc Tools for tools that may be useful (e.g. for generating a list of tables).
Thank you for taking the time to contribute!
You can create an issue or submit a pull request directly. If you submit a pull request, you can see the preview version here after successful rendering.
The HTML versions of documents will be deployed automatically, while the PDF versions will be published manually. If you find an issue about the documents as found on the release page, please cross-check that it is still present in this repo. The issue may have already been corrected, but the changes have not been published yet.
Branch gh-pages is generated by Github Actions, which is used to publish a project site by Github Pages.
So you should not modify this branch directly.
-
This project was inspired by Pro Git, Second Edition.
-
This project use Asciidoctor to generate HTML, and use Asciidoctor PDF to generate documents.
-
See AsciiDoc Language Documentation for AsciiDoc syntax.
-
See asciidoctor-skins for CSS stylesheets for asciidoctor. See Asciidoctor PDF Theming Guide for the style of a PDF file generated by Asciidoctor PDF from AsciiDoc.
Some of the file paths are so long that they exceed the 260-character limit of the Windows API, which can cause some strange problems.
In Windows 10 version 1607 and later, these problems can be solved. If you are using an earlier version, or if you don’t want to do some extra operations, you might consider using docker, refer to Developing on Docker for more details.
The rest is the same as in Getting Start, but JRuby runs much slower and may have cmd popups when running commands.
We assume you know how to develop with Docker. If you don’t, please refer to the official tutorial.
You may find the official Docker container useful.
Since the release of the project, we have gotten several errata and content changes donated. Here are all the people who have contributed to LoongArch Documentation as an open source project. Thank you everyone for helping make this a better book for everyone.
The contributors are listed in alphabetical order.
link:contributors.txt[role=include]