Annotation of wikisrc/users/jruoho/doc.mdwn, revision 1.6
1.5 jruoho 1: [[!meta title="markup test"]]
1.1 jruoho 2:
1.2 jruoho 3: # This is a test page.
4:
5: The conventions used for markup transitions:
6:
1.5 jruoho 7: * <chap> -> ##
8: * <para> -> #
9: * &os; -> NetBSD
1.4 jruoho 10:
11: Problems:
12:
13: * All documents must be HTML ready (the eternal <, >, &, etc.).
1.6 ! jruoho 14: * There seems to be no easy way to define custom macros (cf. &os;, etc.).
! 15: * Only the H1-headers are enumerated in the table of conents.
! 16: * Headers are not enumerated in the body text.
1.2 jruoho 17:
1.6 ! jruoho 18: Benefits:
! 19:
! 20: * Much, much clearer syntax compared to XML. The *Markdown* almost resembles
! 21: plain text. This should be a big benefit in lowering the barriers of entry
! 22: to documentation.
! 23:
! 24: # About NetBSD
1.2 jruoho 25:
1.5 jruoho 26: [[!toc]]
27:
1.4 jruoho 28: ## What is NetBSD?
29:
30: NetBSD is a free, fast, secure, and highly portable Unix-like Open Source
31: operating system. It is available for many platforms, from 64-bit x86 servers
32: and PC desktop systems to embedded ARM and MIPS based devices. Its clean design
33: and advanced features make it excellent in both production and research
34: environments, and it is user-supported with complete source. Many applications
35: are easily available through pkgsrc, the NetBSD Packages Collection.
1.2 jruoho 36:
1.3 jruoho 37: ### The story of NetBSD
1.4 jruoho 38:
39: The first version of NetBSD (0.8) dates back to 1993 and springs from the
40: 4.3BSD Lite operating system, a version of Unix developed at the University
41: of California, Berkeley (BSD = Berkeley Software Distribution), and from the
42: 386BSD system, the first BSD port to the Intel 386 CPU. In the following
43: years, modifications from the 4.4BSD Lite release (the last release from the
44: Berkeley group) were integrated into the system. The BSD branch of Unix has
45: had a great importance and influence on the history of Unix-like operating
46: systems, to which it has contributed many tools, ideas and improvements
47: which are now standard: the vi editor, the C shell, job control, the
48: Berkeley fast file system, reliable signals, support for virtual memory and
49: TCP/IP, just to name a few. This tradition of research and development
50: survives today in the BSD systems and, in particular, in NetBSD.
51:
1.3 jruoho 52: ### NetBSD features
1.4 jruoho 53:
54: NetBSD operates on a vast range of hardware platforms and is very portable.
55: The full source to the NetBSD kernel and userland is available for all the
56: supported platforms; please see the details on the official site of the
57: [NetBSD Project](http://www.NetBSD.org/ "NetBSD").
58:
1.6 ! jruoho 59: * Code quality and correctness
! 60: * Portability to a wide range of hardware
! 61: * Secure defaults
! 62: * Adherence to industry standards
! 63: * Research and innovation
! 64:
! 65: These characteristics bring also indirect advantages. For example, if you work
! 66: on just one platform you could think that you're not interested in portability.
! 67: But portability is tied to code quality; without a well written and well
! 68: organized code base it would be impossible to support a large number of
! 69: platforms. And code quality is the base of any good and solid software system,
! 70: though surprisingly few people seem to understand it.
! 71:
! 72: One of the key characteristics of NetBSD is that its developers are not
! 73: satisfied with partial implementations. Some systems seem to have the
! 74: philosophy of *if it works, it's right*. In that light NetBSD's philosophy
! 75: could be described as *it doesn't work unless it's right*. Think about how
! 76: many overgrown programs are collapsing under their own weight and "features"
! 77: and you'll understand why NetBSD tries to avoid this situation at all costs.
1.5 jruoho 78:
1.6 ! jruoho 79: ### Supported platforms
1.5 jruoho 80:
1.6 ! jruoho 81: NetBSD supports many platforms, including the popular PC platform (i386 and
! 82: amd64), SPARC and UltraSPARC, Alpha, Amiga, Atari, and m68k and PowerPC
! 83: based Apple Macintosh machines. Technical details for all of them can be
! 84: found on [the NetBSD site](http://www.NetBSD.org/ports "NetBSD Ports").
1.5 jruoho 85:
1.3 jruoho 86: ### NetBSD's target users
1.6 ! jruoho 87:
! 88: The NetBSD site states that: *the NetBSD Project provides a freely available
! 89: and redistributable system that professionals, hobbyists, and researchers
! 90: can use in whatever manner they wish*. It is also an ideal system if you
! 91: want to learn Unix, mainly because of its adherence to standards (one of the
! 92: project goals) and because it works equally well on the latest PC hardware
! 93: as well as on hardware which is considered obsolete by many other operating
! 94: systems. To learn and use Unix you don't need to buy expensive hardware; you
! 95: can use that old PC or Mac in your attic. It is important to note that
! 96: although NetBSD runs on old hardware, modern hardware is well supported and
! 97: care has been taken to ensure that supporting old machines does not inhibit
! 98: performance on modern hardware. In addition, if you need a Unix system
! 99: which runs consistently on a variety of platforms, NetBSD is probably your
! 100: best choice.
! 101:
1.3 jruoho 102: ### Applications for NetBSD
1.6 ! jruoho 103:
! 104: Aside from the standard Unix productivity tools, editors, formatters, C/C++
! 105: compilers and debuggers and so on that are included with the base system,
! 106: there is a huge collection of packages (currently over 8,000) that can be
! 107: installed both from source and in pre-compiled form. All the packages that
! 108: you expect to find on a well configured system are available for NetBSD for
! 109: free. The framework that makes this possible, pkgsrc, also includes a
! 110: number of commercial applications. In addition, NetBSD provides binary
! 111: emulation for various other *nix operating systems, allowing you to run
! 112: non-native applications. Linux emulation is probably the most relevant
! 113: example. You can run the Linux versions of
! 114:
! 115: * Firefox
! 116: * the Adobe Flash player plugin
! 117: * Acrobat Reader
! 118: * many other programs
! 119:
1.3 jruoho 120: ### How to get NetBSD
1.6 ! jruoho 121:
! 122: NetBSD is an Open Source operating system, and as such it is freely
! 123: available for download from [ftp.NetBSD.org](ftp://ftp.NetBSD.org
! 124: "ftp.NetBSD.org") and its [mirrors](http://www.NetBSD.org/mirrors/
! 125: "NetBSD mirrors").
! 126:
! 127: There is no "official" supplier of NetBSD CD-ROMs but there are various
! 128: resellers. You can find the most up to date list on the relevant
! 129: [page](http://www.NetBSD.org/sites/cdroms.html "CD-ROMs") on the NetBSD
! 130: site.
! 131:
CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb