Fix for big endian machines
[oweals/busybox.git] / docs / new-applet-HOWTO.txt
index a00dfcc30c0070374c617ff451f9a0a47aa85ba6..7cae30b457c4b81d7da2b2c49d9ec6fe2140245a 100644 (file)
@@ -6,7 +6,7 @@ This document details the steps you must take to add a new applet to BusyBox.
 Credits:
 Matt Kraai - initial writeup
 Mark Whitley - the remix
 Credits:
 Matt Kraai - initial writeup
 Mark Whitley - the remix
-
+Thomas Lundquist - Added stuff for the new directory layout.
 
 Initial Write
 -------------
 
 Initial Write
 -------------
@@ -81,11 +81,25 @@ program that could be useful in another program, consider putting them in
 libbb.
 
 
 libbb.
 
 
+Placement / Directory
+---------------------
+
+Find the appropriate directory for your new applet.
+
+Add the applet to the applet directory Makefile:
+
+obj-$(CONFIG_MU)               += mu.o
+
+Add the applet to the applet directory config.in:
+
+bool 'mu'          CONFIG_MU
+
+
 Usage String(s)
 ---------------
 
 Usage String(s)
 ---------------
 
-Next, add usage information for you applet to usage.h. This should look like
-the following:
+Next, add usage information for you applet to include/usage.h. 
+This should look like the following:
 
        #define mu_trivial_usage \
                "-[abcde] FILES"
 
        #define mu_trivial_usage \
                "-[abcde] FILES"
@@ -104,9 +118,9 @@ currently exist in usage.h.)
 Header Files
 ------------
 
 Header Files
 ------------
 
-Next, add an entry to applets.h.  Be *sure* to keep the list in alphabetical
-order, or else it will break the binary-search lookup algorithm in busybox.c
-and the Gods of BusyBox smite you. Yea, verily:
+Next, add an entry to include/applets.h.  Be *sure* to keep the list 
+in alphabetical order, or else it will break the binary-search lookup 
+algorithm in busybox.c and the Gods of BusyBox smite you. Yea, verily:
 
        /* all programs above here are alphabetically "less than" 'mu' */
        #ifdef CONFIG_MU
 
        /* all programs above here are alphabetically "less than" 'mu' */
        #ifdef CONFIG_MU
@@ -126,13 +140,15 @@ Documentation
 If you're feeling especially nice, you should also document your applet in the
 docs directory (but nobody ever does that).
 
 If you're feeling especially nice, you should also document your applet in the
 docs directory (but nobody ever does that).
 
+Adding some text to docs/Configure.help is a nice start.
+
 
 The Grand Announcement
 ----------------------
 
 Then create a diff -urN of the files you added (<applet>.c, usage.c,
 applets.h, Config.h) and send it to the mailing list:
 
 The Grand Announcement
 ----------------------
 
 Then create a diff -urN of the files you added (<applet>.c, usage.c,
 applets.h, Config.h) and send it to the mailing list:
-busybox@opensource.lineo.com. Sending patches as attachments is preferred, but
+busybox@busybox.net. Sending patches as attachments is preferred, but
 not required.
 
 
 not required.