>From b9a6d8a3ac06759606d52111f784e892c743828e Mon Sep 17 00:00:00 2001 From: Joshua Branson Date: Sat, 15 Dec 2018 10:47:56 -0500 Subject: [PATCH] On the main documentation page: I mentioned how to convert mbox to maildir, and mentioned OS Dev wiki, and added a link to an online OS book in the main documentation page. I also broke some formatting things on the main documentation page, but I believe I fixed them as well. --- documentation.mdwn | 52 +++++++++++++++++++++++++++++++--------------- 1 file changed, 35 insertions(+), 17 deletions(-) diff --git a/documentation.mdwn b/documentation.mdwn index 9300622c..120b6f18 100644 --- a/documentation.mdwn +++ b/documentation.mdwn @@ -16,40 +16,40 @@ or specific components of it? Here is a collection of texts to read. [[!toc levels=3]] - # Basic Knowledge Before you can go details, you have to learn the basics about operating system architecture. Yes, really. - ## Operating Systems Basics -You can find good free, self-paced online courses about operating systems on . -A free textbook about operating systems is called [Operating Systems: Three Easy Pieces](http://pages.cs.wisc.edu/~remzi/OSTEP/). +You can find good free, self-paced online courses about operating systems on [[https://www.udacity.com/]] . +A good operating systems wiki is [[OS Dev|https://wiki.osdev.org/Main_Page]], and it has a page recommending +OS related books: [[https://wiki.osdev.org/Books]]. + +A free textbook about operating systems is called [[Operating Systems: Three Easy Pieces|http://pages.cs.wisc.edu/~remzi/OSTEP/]]. +Another free operating systems concepts textbook is available at [[http://os-book.com/]]. + ## GNU/Hurd System Architecture ### Capabilities -[[!toggleable id=shapiro_capintro_1999 text="""[[!template id=note -text="*[[shapiro\_capintro\_1999|capability]]*: -{{$capability#shapiro_capintro_1999}}. -{{$capability#shapiro_capintro_1999_text}}."]]"""]] - * Our use of [[capabilities|capability]]. The - {{$capability#wikipedia_capability-based_security}} article. - Alternatively/additionally, [[!toggle id=shapiro_capintro_1999 + * Our use of [[capabilities|capability]]. The [[Wikipedia, capability-based + security|https://en.wikipedia.org/wiki/Capability%2Dbased%5Fsecurity]] + article. Alternatively/additionally, [[!toggle id=shapiro_capintro_1999 text="[shapiro\_capintro\_1999]"]]. In the GNU/Hurd system, a [[capability]] is represented by a [[Mach port|microkernel/mach/port]]. - * {{$capability#wikipedia_object-capability_model}}. Albeit not directly - tailored at the GNU/Hurd operating system architecture, this article anyway - does a good job at describing general principles of a [[capability]]-based - system architecture. + * [[Wikipedia, object-capability + model|https://en.wikipedia.org/wiki/Object%2Dcapability%5Fmodel]]. + Albeit not directly tailored at the GNU/Hurd operating system architecture, + this article anyway does a good job at describing general principles of + a [[capability]]-based system architecture. # Quick overview @@ -140,7 +140,25 @@ from userlandish interfaces (Hurd) or from the micro kernel itself (Mach). # IRC Logs -The IRC logs contain wealth of information. Many topics have been covered before in the IRC logs. You can use wget to -download all of the logs and grep for the information that you want. +The IRC logs contain wealth of information. Many topics have been covered +before in the IRC logs. You can use wget to download all of the logs and +grep for the information that you want. `wget --mirror --no-parent -A "hurd-*" -e robots=off http://richtlijn.be/~larstiq/hurd/` + +# Search the email list + +Many technical topics have also been discussed in the +[[bug-hurd@gnu.org|https://lists.gnu.org/mailman/listinfo/bug-hurd]] email list. You can search this email list +[[here|http://lists.gnu.org/archive/html/bug-hurd/]] and download the list in the mbox format +[[here|http://lists.gnu.org/archive/html/bug-hurd/]]. + +`wget -r -A '20*' ftp://lists.gnu.org/bug-hurd/` + +If you prefer to read archived email in the maildir format, then you could use +the perl mbox to maildir converter, which is aptly named mb2md. + + +* Note, if you already have the Hurd installed, then you could instead read the emails +using the mboxfs ontop of the httpfs translator! These translators are +available in the [[hurd extras repo|http://www.nongnu.org/hurdextras/#mboxfs]]. -- 2.19.2