[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

3) DDH --- Examples



 THIS IS ONLY A PRELIMINARY DRAFT !

I consider the "Installation and Administration" part the most complete. the
structure of the several X branches is incomplete. The "Development" part
(esp. below languages) is incomplete. Please mail me any suggestions you
have (please with an explanation and/or example).

Marcus.Brinkmann@ruhr-uni-bochum.de

Debian Document Hierarchy --- Examples
======================================

+---------+
| Debian/ |					[debian]
+---------+
	"Debian-FAQ"
	News/						[news]
		"libc5-libc6-Mini-HOWTO"
	Politics/					[polit]
		"Debian Free Software Guide"
		"Debian Manifeso"
		"Debian Constitution"
	Administration/
		"Dselect" ;)
		"Apt"
		"Kernel-Package"
	Bug Database/					[bugs]
		"Bug Reporting"
		"Bug Mailserver"
		"Bug Maintenance"
	Support/					[support]
		"Mailing Lists"
		Bug Database/@ -> ../Bug Database/		[----]
	Security/					[security]
		"Debian Security"
		"Developer PGP Key Ring"
	Development/					[devel]
		Package Maintenance/				[maint]
			"Debian Packaging Manual"
			"Develpers Reference"
			Policy/						[policy]
				"Debian Policy Manual"
				"Lintian"
				"FSSTND"
				"FHS"
				"Doc Base"
				"Menu System"
				"SGML Entity Reference"
				"Debian Emacs Policy"
			Helper Programs/
				"Lintian"
				"Debhelper"
				"Debmake"
		Dpkg/						[dpkg]
			"Dpkg Internals"

+----------------------------------+
| Installation and Administration/ |		[instadm]
+----------------------------------+
	Cosultants-HOWTO
	Initial Setup/					[setup]
		"Distribution-HOWTO"
		"Installation-HOWTO"
		"Install-From-ZIP"
		"Partition-Rescue"
		"Partition"
		"Diskless"
		Coexistence with other OS/		[coexist]
			"UMSDOS-HOWTO"
			"Linux+DOS+Win95+OS2"
			"Linux+FreeBSD"
			"Linux+NT-Loader"
			"Linux+Win95"
			"Loadlin+Win95"
	Kernel/						[kernel]
		"Kernel-Documentation <version>"
		"Kernel-HOWTO"
		"BootPrompt-HOWTO"
		"Kernel-Package"
		Booting/					[boot]
			"LILO"
			"Loadlin"
			"SRM-HOWTO"
			"MILO-HOWTO"
		Modules/					[modules]
			"Module-HOWTO"
			"Kerneld" (mini)
			"Modules" (mini)
			"Module Utilities"
	Hardware/					[hardware]
		"Hardware-HOWTO"
		Architectures/					[arch]
			"Alpha-HOWTO"
			"Parallel-Processing"
		Laptops/					[laptop]
			"PCMCIA-HOWTO"
			"Battery-Powered"(mini)
		Controllers and Interfaces/			[interf]
			"PCI-HOWTO"
			"SCSI-HOWTO"
			"Ultra-DMA" (mini)
			"PCMCIA-HOWTO"
		Graphic Cards/					[graphic]
			"3dfx-HOWTO"
		Amateur Radio/					[ham]
			"AX25-HOWTO"
		Serial Devices/					[serial]
			"Serial-HOWTO"
			"Boca.gz" (mini)
		Performance/					[perf]
			"Benchmarking-HOWTO"
			"BogoMips" (mini)
		Network/					[net]
			"Ethernet-HOWTO"
			"Cable-Modem"
			"Leased-Line" (mini)
		Input Devices/					[input]
			"Busmouse-HOWTO"
			"3-Button-Mouse"
		Sound Cards/					[sound]
			"Sound-HOWTO"
			"Soundblaster-AWE"
			"AWE Driver FAQ"
		Data Storage Media/				[data]
			"Multi-Disk-HOWTO"
			"Optical-Disk-HOWTO"
			Hard Drives/				[hd]
				Root-Raid-HOWTO.gz
				Large-Disk.gz (mini)
				Ultra-DMA.gz (mini)
				Partition-HOWTO.gz
			Compact Disk/				[cd]
				"CDROM-HOWTO"
				"CD-Writing-HOWTO"
			Tape/					[tape]
				"Ftape-HOWTO"
				"ZIP-Install"
		To Support Impaired/	(title?)		[access]
			"Access-HOWTO"
			"Emacsspeak-HOWTO"
		Miscellaneous/					[misc]
			"Coffe.gz" (mini)
	Software/					[software]
		Booting/@ -> ../Kernel/Booting/			[----]
		Kernel/@ -> ../Kernel/				[----]
		Backup/						[backup]
			"Backup-With-MSDOS" (mini)
			"AfBackup"
			"cpio" (info)
			"tar" (info)
		Keyboard and Console/				[terminal]
			"Keyboard and Console HOWTO"
			SVGATextMode/				[svgatextmode] 
				Installation
				Frequent Asked Questions
				Creating Textmodes
		Input Devices/					[input]
			"GPM" (info)
			"GPM FAQ"
		Communication/					[comm]
			"Fax-Server" (mini)
			"HylaFax"
			"mgetty"
		Printer/					[printer]
			"Printing-HOWTO"
			LPRng/						[lprng]
				"Intro"
				"Tutorial"
			Filter/						[filter]
				"Magicfilter"
				"GhostScript"
				"File"
		Network/					[net]
			"NET-3-HOWTO"
			"IP-Alias" (mini)
			"IP-Subnetworking" (mini)
			Dial Up Connection/				[dialup]
				"Diald" (mini)
				"ISP-Hookup-HOWTO"
			Firewall and Masquerading/			[firewall]
				"Firewall-HOWTO"
				"IP-Masquerade" (mini)
				"Bridge+Firewall" (mini)
			Bridge/						[bridge]
				"Bridge.gz" (mini)
				"Bridge+Firewall" (mini)
			Protocols/					[proto]
				"IPX HOWTO"
				"SMB HOWTO"
				"DHCPcd" (mini)
				"xntp"
				UUCP/						[uucp]
					"UUCP HOWTO"
					"Sendmail+UUCP" (mini)
				PPP/						[ppp]
					"PPP HOWTO"
					"PPP FAQ"
					"PPPconfig"
			Services/
				"DNS-HOWTO"
				"Bind"
				"Intranet-Server-HOWTO"
				"NIS-HOWTO"
				"NFS-HOWTO"
				"Virtual-Services-HOWTO"
				Mail/						[mail]
					"Mail HOWTO"
					"Mail2News" (mini)
					"Offline Mailing" (mini)
					"Cyrux IMAP" (mini)
					"Qmail+MH"
					Sendmail/					[sendmail]
						"Sendmail+UUCP"
						"Mail-Queue"
					Exim/						[exim]
						"Exim Overview"
						"Exim Manual"
						"Exim Filter"
				News/						[news]
					"News HOWTO"
					"Mail2News" (mini)
					"News Leafsite" (mini)
					Inn/						[inn]
						"[whatever there is]"
				World Wide Web/					[www]
					"Apache"
					"WWW HOWTO"
					"WWW-mSQL HOWTO"
					"Java-CGI HOWTO"
					"Public-Web-Browser"
				Miscellaneous/					[misc]
					"xntp"
			X/@ -> ../X/Network/				[----]
		Database/					[db]
			"Database-HOWTO"
			SQL/					[sql]
				"WWW-mSQL-HOWTO"
		X/						[x]
			"XFree86 HOWTO"
			"XFree86 Video Timings HOWTO"
			Network/					[net] 
				"VNC"
				"LBX" (mini)
			Window Manager/					[wm]
				"Gwm"
			Desktop Environments/				[de]
				"Gnome"
				"KDE"
		Amateur Radio/					[ham]
			"Ham HOWTO"
		Miscellaneous/					[misc]
			"Pilot HOWTO"
			"Clock"
	Internationalisation and Localisation/		[locales]
                "Chinese-HOWTO"
                "Cyrillic-HOWTO"
                "Danish-HOWTO"
                "German-HOWTO"
                "Finnish-HOWTO"
                "French-HOWTO"
                "Hebrew-HOWTO"
                "Italian-HOWTO"
                "Polish-HOWTO"
                "Portuguese-HOWTO"
                "Slovenian-HOWTO"
                "Spanish-HOWTO"
                "Thai-HOWTO"

	Security/					[security]
		Debian/@ -> ../../Debian/Security		[----]
		"Security HOWTO"
		"Shadow Password HOWTO"


+----------------+
| User's Manuals |					[user]
+----------------+
	Shells/						[shell]
		Bash/						[bash]
			"Bash" (info)
			"FAQ"
	Other Operating Systems/			[otheros]
		"MTools" (info)
		Emulators/					[emu]
			"Wine"
			"Vice"
			"Atari"
			Dosemu/						[dosemu]
				"Quickstart"
				"DOSEMU Howto"
	Games/						[games]
		"Angband Doc"
		"LambdaMOO USer Manual"
	Printing/					[printing]
		"Printing-Usage-HOWTO"
		LPRng
	Sound/						[sound]
		"Sound Playing HOWTO"
		"AWE Driver FAQ"
		"Timidity FAQ"
	Text Editors/					[edit]
		"THE"
		Vi/						[vi]
			"NVI FAQ"
		Emacsen/					[emacs]
			"Emacs 20"
			"XEmacs 20"
	Email/						[mail]
		"PGP"
		"Mutt"
		"Fetchmail"
		Filter/						[filter]
			"Procmail"
			"Exim Filter" (info)
			"MailAgent"
	World Wide Web/					[www]
		Browser/
			"Lynx User Guide"			[browser]
		HTML/						[html]
			Development/@ ->../../../Development/Languages/World Wide Web/
			"SelfHTML"
	Text Processing and Document Formats/		[text]
		"Ispell" (info)
		SGML/						[sgml]
			"SGML Tools"
			"SP"
			"Linuxdoc-sgml" (info)
			"Docbook Documentation"
			"Docbook Stylesheets"
			"Jade"
		TeX and LaTeX/					[tex]
			"DviPS" (info)
			"Fontname" (info)
			"LaTeX2e" (info)
			"Makeinfo" (info)
			"TeXinfo" (info)
		PostScript/					[ps]
			"GhostView"
			"DviPS"
		PDF/						[pdf]
			"Acrobat Reader"
			"GhostView"
		Groff/						[groff]
			"Groff"
			"Troff"
		Info/						[info]
			"Info Reader" (info)
			"Makeinfo" (info)
			"TeXinfo" (info)
	Science/					[science]
		"GnuPlot"
		"SciLab"
		Mathematics/					[math]
			"Octave"
			"BC"
			"DC"
			"Felt"
		Physics and Astronomy/				[physik]
			"Xephem"
	Graphic Processing/				[graphic]
		"Gimp"
		"ImageMagick"
		3D/						[threed]
			"PovRay"
			"Moonlight Creator"
			"Blender"
	X/						[x]
		Window Managers/@ -> ../../Inst&Admin/Software/X/Window Manager/
		Desktop Environments/				[de]
			"Gnome"
			"KDE"

+--------------+
| Development/ |			*1*	[devel]
+--------------+
	Debian/@ -> ../Debian/Development/		[----]
	Building/					[build]
		"CVS"
		"Automake" (info)
		"Autoconf" (info)
		"Ld" (info)
		"Make" (info)
	Debugging/					[debug]
		"Gdb"
		"xxgdb"
		"Data Display Debugger"
	Kernel/						[kernel]
		"Kernel Doc <version>"
		Driver/						[driver]
			"awedrv-prog"
			"SCSI Programming HOWTO"
			"Serial Programming HOWTO"
	Languages/					[lang]
		Preprocessor/					[pp]
			"Gasp" (info)
			"Cpp" (info)
			"M4" (info)
		Assembler/					[asm]
			"Gasp" (info)
			"As" (info)
		Parser Generator/				[parser]
			"Bison" (info)
			"Flex" (info)
		C/						[c]
			Compiler/					[comp]
				"Cpp" (info)
				"Gcc" (info)
				"EGcc" (info)
				"PGcc" (info)
			Libraries/					[lib]
				"libc5"
				"libc6"
				"Gtk"
		C++/						[cxx]
			Compiler/					[comp]			
				"Cpp"
				"G++"
				"EG++"
			Libraries/					[lib]
				"libstdc++"
				"libg++"
				"Gtk--"
		Java/						[java]
			"Java-CGI-HOWTO"
			Compiler/					[comp]
				"Jdk"
				"Kaffee"
			Classes/					[class]
		Perl/						[perl]
			"Perl"
			Modules/					[modules]
		Python/						[python]
			"Python"
		Scheme/						[scheme]
			"Scheme Report"
			"Elk"
		SQL/						[sql]
			"Postgresql"
		World Wide Web/			*2*		[www]
			Java/@ -> ../Java/				[----]
			"PHP"
			"WML"
		Miscellaneous/					[misc]
			"Icon"
			"Ilu"
			"LambdaMOO"
	Libraries/					[lib]
		"libc5"
		"libc6"
		"libstc++"
		"libg++"
		Graphical User Interfaces/			[gui]
			"Lesstif"
			"Gtk"
			"Gtk--"
			"GLUT"
		Graphic/					[graphic]
			"libjpeg"
			"libmpeg"
			"libtiff"
			"iv"
			"mesa"
		Math/						[math]
			"lapack"
		Security/					[security]
			"libpam"
			"libpwd"

*1*: All below level two is only example. This depends heavily on existing
     documentation and programs for the language.
*2*: This is intended for CGI, Java, PHP, wml, etc...

-- 
"Rhubarb is no Egyptian god."        Debian GNU/Linux        finger brinkmd@ 
Marcus Brinkmann                   http://www.debian.org    master.debian.org
Marcus.Brinkmann@ruhr-uni-bochum.de                        for public  PGP Key
http://homepage.ruhr-uni-bochum.de/Marcus.Brinkmann/       PGP Key ID 36E7CD09


--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org


Reply to: