Home | History | Annotate | Line # | Download | only in external
README revision 1.2 
      1 $NetBSD: README,v 1.2 2008/07/05 23:52:33 minskim Exp $
      2 
      3 Organization of Sources:
      4 
      5 This directory hierarchy is using an organization that separates
      6 source for programs that we have obtained from external third
      7 parties (where NetBSD is not the primary maintainer) from the
      8 system source.
      9 
     10 The hierarchy is grouped by license, and then package per license,
     11 and is organized as follows:
     12 
     13 	external/
     14 
     15 	    Makefile
     16 			Descend into the license sub-directories.
     17 
     18 	    <license>/
     19 			Per-license sub-directories.
     20 
     21 		Makefile
     22 			Descend into the package sub-directories.
     23 
     24 		<package>/
     25 			Per-package sub-directories.
     26 
     27 		    Makefile
     28 			Build the package.
     29 			
     30 		    dist/
     31 			The third-party source for a given package.
     32 
     33 		    bin/
     34 		    lib/
     35 		    sbin/
     36 			BSD makefiles "reach over" from these into
     37 			"../dist/".
     38 
     39 This arrangement allows for packages to be easily disabled or
     40 excised as necessary.
     41 
     42 The licenses currently used are:
     43 
     44 	bsd	BSD (or equivalent) licensed software, possibly with
     45 		the "advertising clause".
     46 
     47 
     48 Eventually src/dist (and associated framework in other base source
     49 directories) and src/gnu will be migrated to this hierarchy.
     50 
     51 
     52 Maintenance Strategy:
     53 
     54 The sources under src/external/<license>/<package>/dist/ are
     55 generally a combination of a published distribution plus changes
     56 that we submit to the maintainers and that are not yet published
     57 by them.
     58 
     59 Make sure all changes made to the external sources are submitted
     60 to the appropriate maintainer, but only after coordinating with
     61 the NetBSD maintainers.
     62