[rtems-libbsd commit] Add some doco on reverse and forward movement of the code.

[Chris Johns]

Module:    rtems-libbsd
Branch:    master
Commit:    1e8c93c987189ef92d9a80ff80e556416e091917
Changeset: http://git.rtems.org/rtems-libbsd/commit/?id=1e8c93c987189ef92d9a80ff80e556416e091917

Author:    Chris Johns <chrisj at rtems.org>
Date:      Wed May  4 15:59:16 2016 +1000

Add some doco on reverse and forward movement of the code.

---

 libbsd.txt | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/libbsd.txt b/libbsd.txt
index a122266..c6adad8 100644
--- a/libbsd.txt
+++ b/libbsd.txt
@@ -586,13 +586,23 @@ not changed unless the contents change. The script will also report the
 number of files which changed. In verbose mode, the script will print
 the name of the files which are changed.
 
+To add or update files int the RTEMS FreeBSD tree first run the 'reverse mode'
+and move the current set of patches FreeBSD. The script may warn you if a file
+is not present at the destination for the direction. This can happen as files
+not avaliable at the FreeBSD snapshot point have been specially added to the
+RTEMS FreeBSD tree. Warnings can also appear if you have changed the list of
+files in libbsd.py. The reverse mode will result in the FreeBSD having
+uncommitted changes. You can ignore these. Once the reverse process has
+finished edit libbsd.py and add any new files then run the forwad mode to bring
+those files into the RTEMS FreeBSD tree.
+
 The following is an example forward run with no changes.
 
 ----
 $ ~/newbsd/git/libbsd-8.2/freebsd-to-rtems.py \
     -r /home/joel/newbsd/git/libbsd-8.2 \
     -f /home/joel/newbsd/libbsd/freebsd-8.2 -v
-Verbose:                yes
+Verbose:                yes (1)
 Dry Run:                no
 Only Generate Makefile: no
 RTEMS Directory:        /home/joel/newbsd/git/libbsd-8.2
@@ -605,6 +615,9 @@ Generating into /home/joel/newbsd/git/libbsd-8.2
 The script may also be used to generate a diff in either forward or reverse
 direction.
 
+You can add more than one verbose option (-v) to the command line and get more
+detail and debug level information from the command.
+
 == Initialization of the BSD Library
 
 The initialization of the BSD library is based on the FreeBSD SYSINIT(9)
@@ -1114,6 +1127,18 @@ E1000 EM		_bsd_em_pcimodule_sys_init	Links
 Cadence			?				Links, works.
 ----
 
+To add a NIC edit rtemsbsd/include/bsp/nexus-devices.h and add the driver
+reference to the architecture and/or BSP. For example to add the RealTek driver
+add:
+
+SYSINIT_DRIVER_REFERENCE(re, pci);
+
+and to add the MII PHY driver add:
+
+SYSINIT_DRIVER_REFERENCE(rge, miibus);
+
+The PC BSP has these entries.
+
 Symbols (A)
          pci_get_vpd_ident