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