From patchwork Wed Nov 28 21:40:32 2012
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: [6/6] manual: add generated *-list.txt
From: Samuel Martin <s.martin49@gmail.com>
X-Patchwork-Id: 202557
Message-Id: <1354138832-18149-6-git-send-email-s.martin49@gmail.com>
To: buildroot@busybox.net
Date: Wed, 28 Nov 2012 22:40:32 +0100

* update package-list.txt (formerly named pkg-list.txt)
* update deprecated-list.txt
* update appendix.txt (which include these 2 generated files)

Signed-off-by: Samuel Martin <s.martin49@gmail.com>

---
docs/manual/appendix.txt                       | 13 ++---
 docs/manual/deprecated-list.txt                | 68 ++++++++++++++++----------
 docs/manual/{pkg-list.txt => package-list.txt} | 12 +++++
 3 files changed, 57 insertions(+), 36 deletions(-)
 rename docs/manual/{pkg-list.txt => package-list.txt} (96%)

diff --git a/docs/manual/appendix.txt b/docs/manual/appendix.txt
index 6f1e9f3..4524073 100644
--- a/docs/manual/appendix.txt
+++ b/docs/manual/appendix.txt
@@ -5,15 +5,8 @@ Appendix
 
 include::makedev-syntax.txt[]
 
-[[package-list]]
-Available packages
-------------------
-// docs/manaual/pkg-list.txt is generated using the following command:
-// $ git grep -E '\((autotools|cmake|generic)-package\)' package/ |  \
-//     cut -d':' -f1 | grep '\.mk$' | \
-//     sed -e 's;.*\?/\(.*\?\).mk;* \1;' | \
-//     sort > docs/manual/pkg-list.txt
-
-include::pkg-list.txt[]
+// autogenerated
+include::package-list.txt[]
 
+// autogenerated
 include::deprecated-list.txt[]
diff --git a/docs/manual/deprecated-list.txt b/docs/manual/deprecated-list.txt
index 6dc87a4..1efab7f 100644
--- a/docs/manual/deprecated-list.txt
+++ b/docs/manual/deprecated-list.txt
@@ -1,4 +1,6 @@
-// -*- mode:doc -*- ;
+//
+// Autogenerated file
+//
 
 [[deprecated]]
 Deprecated list
@@ -7,40 +9,54 @@ Deprecated list
 The following stuff are marked as _deprecated_ in Buildroot due to
 their status either too old or unmaintained.
 
-// list generated using the followings command:
+// Please check and sort by grepping the source running:
+//
 // $ git grep -EB4 'depends on BR2_DEPRECATED'
-// and
+//
+// and:
+//
 // $ git grep -EB4 'depends on BR2_DEPRECATED' | \
 //     grep -Eo '(:|-).*?(config|comment) BR2_.*'
-//
-// Need manual checks and sorting.
 
-* Packages:
+* Build options:
 
-** +busybox+ 1.18.x
-** +customize+
-** +lzma+
-** +microperl+
-** +netkitbase+
-** +netkittelnet+
-** +pkg-config+
-** +squashfs3+
-** +ttcp+
+** have devfiles             +[development files in target filesystem]+
+** have documentation        +[documentation on the target]+
 
 * Toolchain:
 
-** +gdb+ 6.8
-** +gdb+ 7.0.1
-** +gdb+ 7.1
-** +kernel headers+ 2.6.37
-** +kernel headers+ 2.6.38
-** +kernel headers+ 2.6.39
+** gcc target                +[gcc]+
+** gdb                       +[Build gdb debugger for the Target]+
+** gdb 6.8                   +[gdb 6.8]+
+** gdb 7.0.1                 +[gdb 7.0.1]+
+** gdb 7.1                   +[gdb 7.1]+
+** kernel headers 2.6.37     +[Linux 2.6.37.x kernel headers]+
+** kernel headers 2.6.38     +[Linux 2.6.38.x kernel headers]+
+** kernel headers 2.6.39     +[Linux 2.6.39.x kernel headers]+
+
+* Package selection:
+
+** autoconf                  +[autoconf]+
+** automake                  +[automake]+
+** binutils 2.20             +[binutils 2.20]+
+** busybox 1.18.x            +[BusyBox 1.18.x]+
+** customize                 +[customize]+
+** libtool                   +[libtool]+
+** lzma                      +[lzma]+
+** make                      +[make]+
+** microperl                 +[microperl]+
+** netkitbase                +[netkitbase]+
+** netkittelnet              +[netkittelnet]+
+** pkg config                +[pkg-config]+
+** squashfs3                 +[squashfs3]+
+** ttcp                      +[ttcp]+
+
+* Filesystem images:
+
+** target rootfs squashfs3   +[3.x]+
 
 * Bootloaders:
 
-** +u-boot+ 2011-06
-** +u-boot+ 2011-09
-
-* Output images:
+** target uboot 2011.06      +[2011.06]+
+** target uboot 2011.09      +[2011.09]+
 
-** squashfs3 image
diff --git a/docs/manual/pkg-list.txt b/docs/manual/package-list.txt
similarity index 96%
rename from docs/manual/pkg-list.txt
rename to docs/manual/package-list.txt
index 5d9b54f..d8b2530 100644
--- a/docs/manual/pkg-list.txt
+++ b/docs/manual/package-list.txt
@@ -1,3 +1,14 @@
+//
+// Autogenerated file
+//
+
+[[package-list]]
+Available packages
+------------------
+
+// docs/manaual/pkg-list.txt is generated using the following command:
+// git grep -E '\((autotools|cmake|generic)-package\)' package/ | \n//     cut -d':' -f1 | grep '\.mk$' | \n//     sed -e 's;.*\?/\(.*\?\).mk;* \1;' | \n//     sort > docs/manual/pkg-list.txt
+
 * acl
 * acpid
 * alsa-lib
@@ -346,6 +357,7 @@
 * luaexpat
 * luafilesystem
 * luajit
+* lua-msgpack-native
 * luasocket
 * lvm2
 * lzma