[PATCH] move board.dox to Documentation and update it

Jean-Christophe PLAGNIOL-VILLARD plagnioj at jcrosoft.com
Sun Aug 22 02:48:56 EDT 2010


Signed-off-by: Jean-Christophe PLAGNIOL-VILLARD <plagnioj at jcrosoft.com>
---
 Documentation/board.dox      |   95 ++++++++++++++++++++++++++++++++++++++++++
 Documentation/manual_org.dox |    4 +-
 board/board.dox              |   95 ------------------------------------------
 3 files changed, 97 insertions(+), 97 deletions(-)
 create mode 100644 Documentation/board.dox
 delete mode 100644 board/board.dox

diff --git a/Documentation/board.dox b/Documentation/board.dox
new file mode 100644
index 0000000..07425e4
--- /dev/null
+++ b/Documentation/board.dox
@@ -0,0 +1,95 @@
+/** @page dev_board Adapting a new Board
+
+To add a new board to @a barebox a few steps must be done, to extend and modify
+the @a barebox source tree.
+
+ at section board_add_files Files/Directories to be added
+
+ - arch/\<architecture\>/boards/\<boardname\>
+ - arch/\<architecture\>/boards/\<boardname\>/Makefile
+ - arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.c
+ - arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.dox
+ - include/configs/\<boardname\>.h
+ - arch/\<architecture\>/configs/\<boardname\>_defconfig
+
+ at subsection board_makefile arch/\<architecture\>/boards/\<boardname\>Makefile
+
+ at verbatim
+	obj-y += all files that builds the BSP (Assembler and/or C files)
+ at endverbatim
+
+ at subsection board_basefile arch/\<architecture\>/boards/\<boardname\>\<boardname\>.c
+
+TBD
+
+ at subsection board_doxygen arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.dox
+
+This file should describe in short words your new board, what CPU
+it uses, what resources are provided and features it supports.
+
+Use the doxygen style for this kind of documentation. Below you find a
+template for this kind of file:
+
+ at verbatim
+/** @page <boardname> <Manufacturer> <Board's Name>
+
+This board uses an <architecture> based CPU. The board is shipped with:
+
+- many MiB NOR type Flash Memory
+- many MiB SDRAM
+- a very special network controller
+
+and so on.
+
+*/
+ at endverbatim
+
+To make your new shiny file visible in the automatically generated
+documentation you must sort in the used page lable ("<boardname>" in the
+template above) into Documentation/boards.dox as:
+
+ at verbatim
+ ...
+ @subpage <boardname>
+ ...
+ at endverbatim
+
+at the right architecture.
+
+ at note Consider to use an unique page lable.
+
+ at subsection board_lscript arch/\<architecture\>/boards/\<boardname\>/barebox.lds.S
+
+If your board needs a special binary @a barebox layout, you can provide a local
+board linker script file. This will replace the generic one provided by your
+architecture or CPU support.
+
+Add this file with
+
+ at verbatim
+	extra-y += <board_linker_script>
+ at endverbatim
+
+in your local \b Makefile to the list of files, forwarded to the last linking step.
+
+ at section board_defconfig arch/\<architecture\>/configs/\<boardname\>_defconfig
+
+TBD
+
+ at section board_mod_files These files needs to be modified:
+
+ - modify Documentation/board.dox
+ - modify arch/\<architecture\>/Kconfig
+  - add your board (MACH_*) to the list
+  - add your default text base address for this architecture (ARCH_TEXT_BASE)
+  - add BOARDINFO with valueable info for your board
+ - modify arch/\<architecture\>/Makefile:
+  - add board-$(MACH_*) = \<your board_dir\>
+
+First, the new board should be visible in the menu.
+
+ at section board_specific_cpu Porting hints for specific CPUs
+
+ at li @subpage dev_s3c24xx_mach
+
+*/
diff --git a/Documentation/manual_org.dox b/Documentation/manual_org.dox
index 6f3b157..17238f0 100644
--- a/Documentation/manual_org.dox
+++ b/Documentation/manual_org.dox
@@ -10,7 +10,7 @@ than listed here. But these files are the main control files:
    - Documentation/users_manual.dox
     - Documentation/commands.dox
    - Documentation/developers_manual.dox
-    - board/board.dox
+    - Documentation/board.dox
     - arch/architecture.dox
      - arch/arm/mach-arm.dox
      - arch/blackfin/mach-bf.dox
@@ -24,4 +24,4 @@ their pages should be listed in this file.
 
 New boards should forward their content to Documentation/boards.dox, so
 their pages should be listed in this file.
-*/
\ No newline at end of file
+*/
diff --git a/board/board.dox b/board/board.dox
deleted file mode 100644
index 6bda416..0000000
--- a/board/board.dox
+++ /dev/null
@@ -1,95 +0,0 @@
-/** @page dev_board Adapting a new Board
-
-To add a new board to @a barebox a few steps must be done, to extend and modify
-the @a barebox source tree.
-
- at section board_add_files Files/Directories to be added
-
- - arch/\<architecture\>/boards/\<boardname\>
- - arch/\<architecture\>/boards/\<boardname\>/Makefile
- - arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.c
- - arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.dox
- - include/configs/\<boardname\>.h
- - arch/\<architecture\>/configs/\<boardname\>_defconfig
-
- at subsection board_makefile arch/\<architecture\>/boards/\<boardname\>Makefile
-
- at verbatim
-	obj-y += all files that builds the BSP (Assembler and/or C files)
- at endverbatim
-
- at subsection board_basefile arch/\<architecture\>/boards/\<boardname\>\<boardname\>.c
-
-TBD
-
- at subsection board_doxygen arch/\<architecture\>/boards/\<boardname\>/\<boardname\>.dox
-
-This file should describe in short words your new board, what CPU
-it uses, what resources are provided and features it supports.
-
-Use the doxygen style for this kind of documentation. Below you find a
-template for this kind of file:
-
- at verbatim
-/** @page <boardname> <Manufacturer> <Board's Name>
-
-This board uses an <architecture> based CPU. The board is shipped with:
-
-- many MiB NOR type Flash Memory
-- many MiB SDRAM
-- a very special network controller
-
-and so on.
-
-*/
- at endverbatim
-
-To make your new shiny file visible in the automatically generated
-documentation you must sort in the used page lable ("<boardname>" in the
-template above) into Documentation/boards.dox as:
-
- at verbatim
- ...
- @subpage <boardname>
- ...
- at endverbatim
-
-at the right architecture.
-
- at note Consider to use an unique page lable.
-
- at subsection board_lscript arch/\<architecture\>/boards/\<boardname\>/barebox.lds.S
-
-If your board needs a special binary @a barebox layout, you can provide a local
-board linker script file. This will replace the generic one provided by your
-architecture or CPU support.
-
-Add this file with
-
- at verbatim
-	extra-y += <board_linker_script>
- at endverbatim
-
-in your local \b Makefile to the list of files, forwarded to the last linking step.
-
- at section board_defconfig arch/\<architecture\>/configs/\<boardname\>_defconfig
-
-TBD
-
- at section board_mod_files These files needs to be modified:
-
- - modify board/board.dox
- - modify arch/\<architecture\>/Kconfig
-  - add your board (MACH_*) to the list
-  - add your default text base address for this architecture (ARCH_TEXT_BASE)
-  - add BOARDINFO with valueable info for your board
- - modify arch/\<architecture\>/Makefile:
-  - add board-$(MACH_*) = \<your board_dir\>
-
-First, the new board should be visible in the menu.
-
- at section board_specific_cpu Porting hints for specific CPUs
-
- at li @subpage dev_s3c24xx_mach
-
-*/
-- 
1.7.1




More information about the barebox mailing list