diff options
Diffstat (limited to 'contributing/web_pages')
| -rw-r--r-- | contributing/web_pages/news.mdwn | 36 | ||||
| -rw-r--r-- | contributing/web_pages/news/moth_next.mdwn | 11 | ||||
| -rw-r--r-- | contributing/web_pages/news/qoth_next.mdwn | 118 | ||||
| -rw-r--r-- | contributing/web_pages/news/skeleton.mdwn | 60 | ||||
| -rw-r--r-- | contributing/web_pages/news/writing_the_qoth.mdwn | 79 |
5 files changed, 304 insertions, 0 deletions
diff --git a/contributing/web_pages/news.mdwn b/contributing/web_pages/news.mdwn new file mode 100644 index 00000000..920fdba8 --- /dev/null +++ b/contributing/web_pages/news.mdwn @@ -0,0 +1,36 @@ +[[!meta copyright="Copyright © 2009, 2010, 2011, 2012 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +[[!meta title="""How to prepare and publish a "Quarter of the Hurd" for the last +quarter"""]] + +We prepare a *Quarter of the Hurd* in the file [[qoth_next]]. The idea is +to record to-be-published changes in that file at they time they arise, and +then publish them en bloc at the end of the quarter. There are instructions for +[[writing_the_qoth]]. + + * At the end of the quarter: prepare for publishing the QotH, then send the raw + Markdown text to the mailing list, asking for feedback. + + * ..., and publish. + + $ git mv contributing/web_pages/news/qoth_next.mdwn news/YYYY-MM.mdwn + + Edit the news entry's *meta date* value to the timestamp when the news + entry is published. We have to set that one manually, as otherwise the + timestamp of the news entry file's creation will be taken, which is (much) + earlier, and not what we want. We do not set the *meta updated* value, as + it's correct to update that one upon further modifications of the news + entries. + + $ git cp contributing/web_pages/news/skeleton.mdwn contributing/web_pages/news/qoth_next.mdwn + $ git commit -m 'QotH YYYY-MM.' + $ git push origin master diff --git a/contributing/web_pages/news/moth_next.mdwn b/contributing/web_pages/news/moth_next.mdwn new file mode 100644 index 00000000..e430f650 --- /dev/null +++ b/contributing/web_pages/news/moth_next.mdwn @@ -0,0 +1,11 @@ +[[!meta copyright="Copyright © 2012 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +[[!meta redir=qoth_next]] diff --git a/contributing/web_pages/news/qoth_next.mdwn b/contributing/web_pages/news/qoth_next.mdwn new file mode 100644 index 00000000..4b7a6f63 --- /dev/null +++ b/contributing/web_pages/news/qoth_next.mdwn @@ -0,0 +1,118 @@ +[[!meta copyright="Copyright © 2012 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +<!-- Date when the news item is (to be) pulished (important for RSS feeds). +Will be set by tschwinge when publishing. +[[!meta date="YYYY-MM-DD HH:MM UTC"]] +--> + +<!-- This is just a skeleton. Use it to create a new QotH. --> + +A quarter of the Hurd, Q1 of 2012: *TODO*, *TODO*, and *TODO*. +[[!if test="included()" then="""[[!toggle id=full_news +text="Details."]][[!toggleable id=full_news text="[[!paste id=full_news]]"]]""" +else=" +[[!paste id=full_news]]"]] + +[[!cut id="full_news" text=""" + +<!--basic structure of a QotH entry. Adapt, reduce and add points as needed. At the end, try to make the text flow as a unified whole.--> + +* Jeremie Koenig released the final report on his GSoC project Java on Hurd http://www.bddebian.com/~hurd-web/user/jkoenig/java/report along with a summary of his changes and the challenges he bested http://lists.gnu.org/archive/html/bug-hurd/2012-01/msg00062.html . + +* Richard Braun [libpcap](http://lists.gnu.org/archive/html/bug-hurd/2012-01/msg00059.html) bringing wireshark and [pcap_inject](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00000.html) for easier network testing. + +* Samuel Thibault prepared dde in incubator, making about half the Linux network drivers compile on the Hurd http://lists.gnu.org/archive/html/bug-hurd/2012-02/msg00037.html . Also he added the netdde debian package and testing notes http://lists.gnu.org/archive/html/bug-hurd/2012-02/msg00038.html . + +* Peter O'Gorman pushed the fix from Samuel Thibault to fix libtool on the Hurd. http://lists.gnu.org/archive/html/bug-hurd/2012-02/msg00023.html + +* Samuel Thibault merged the slab branch, finishing Maksym Planetas GSoC work on a better memory allocator http://lists.gnu.org/archive/html/bug-hurd/2012-02/msg00010.html . + +* Thomas Schwinge [moved](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00063.html) the translators [cvsfs](http://git.savannah.gnu.org/cgit/hurd/incubator.git/log/?h=cvsfs/master), [libfuse](http://git.savannah.gnu.org/cgit/hurd/incubator.git/log/?h=libfuse/master) and [smbfs](http://git.savannah.gnu.org/cgit/hurd/incubator.git/log/?h=smbfs/master) into the incubator git repository, reducing the barrier of entry to improving them, so integrating cvs and samba in the filesystem and using FUSE translators can be stabilized more easily. + +* Svante Signell [added](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00060.html) the basics of ADA support by making gnat build. This gives us the option to use provable programs optimized for embedded systems with the Hurd. + +* Maksym Planeta published some [performance tests of tmpfs](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00040.html), showing a speedup from 22s with ramfs and ext2fs to 16s with tmpfs for apt-get calls. An obvious usecase for tmpfs are [faster Hurd LiveCDs](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00050.html). + +* Samuel Thibault [improved debugging in GNU Mach](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00032.html) by making the debugger aware of the difference between kernel space and user space. This should substantially reduce the development time for features in Mach by giving [nicer stack traces](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00047.html). + +* Ludovic Courtès added [a continuous testing framework](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00019.html) using a Nix-based GNU QEMU image. Since Hurd can now be built using „Nix“ (german for nothing), how about asking a colleague to revise his image of the Hurd as vaporware and showing him vapor chugging away on a compile of your favorite free program? If you don’t want to install it yourself, you can also check the [automatic tests on hydra](http://hydra.nixos.org/jobset/gnu/hurd-master) ([background](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00104.html)). + +* Ludovic Courtes [fixed invalid port deallocation in `symlink'](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00013.html) and [made console-run resilient against missing /dev/console](http://lists.gnu.org/archive/html/bug-hurd/2012-03/msg00002.html), improving the overall reliability of the system. + +* Pino Toscano improved the POSIX compliance of the Hurd [for nanosleep](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00130.html) [ptsname_r](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00122.html), +[getlogin_r](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00121.html), [getgroups](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00120.html) and [sendto](http://lists.gnu.org/archive/html/bug-hurd/2012-06/msg00009.html), making it easier to port POSIX programs. + +* Richard brown improved memory mapping [with a red-black tree](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00109.html), which should speed up memory access. + +* Thomas Schwinge [improved the Hurd build system](http://lists.gnu.org/archive/html/bug-hurd/2012-04/msg00087.html), making it easier to get in: „running autoreconf is all you need“. + +* Thomas DiModica [merged](http://lists.gnu.org/archive/html/bug-hurd/2012-06/msg00018.html) the cthreads to pthreads patch to Hurd master and [added a branch for it](http://lists.gnu.org/archive/html/bug-hurd/2012-07/msg00087.html) to make it easier to work on getting Hurd to use the more current pthreads. + +* Samuel Thibault [added TLS support](http://lists.gnu.org/archive/html/bug-hurd/2012-05/msg00046.html), further improving the standards conformance of the Hurd and paving the way for C++11x. + +* Roland McGrath [merged many libc changes](http://lists.gnu.org/archive/html/bug-hurd/2012-05/msg00033.html) for upstream inclusion, reducing the maintenance load for getting recent improvements of libc. + +* Samuel Thibault [made iconx build](http://lists.gnu.org/archive/html/bug-hurd/2012-06/msg00004.html), which fullfills a requirement for FTBFS. + +------ Q3 ------ + +* Richard Braun [added a VM page cache](http://lists.gnu.org/archive/html/bug-hurd/2012-07/msg00031.html) for better response times of the Hurd - along with fixes to bugs in several programs exposed by the increased freedom of the memory allocation of the kernel. + +* Pino Toscano improved the POSIX compliance of the Hurd for [fsync](http://lists.gnu.org/archive/html/bug-hurd/2012-08/msg00067.html) and +[ptrace](http://lists.gnu.org/archive/html/bug-hurd/2012-08/msg00068.html), making it easier to port POSIX programs. + +This quarter [hurd hacker] [item] + +Also … + +[our hackers] … + +Mainly thanks to … + +Additionally … + +And … + +Now, as a final note, we want to share a story about real-life debugging with the +Hurd; IRC, freenode, #hurd, 2012-03-02: + + <youpi> yay GNU/Hurd + <youpi> I have added i_translator check in e2fsck, it was missing + <youpi> I had a volume that was keeping making ext2fs crash + <youpi> with a reproductible scenario + <youpi> could easily work out it was i_translator, then add a + check to e2fsck, run it, which indeed fixed, them, and voilà, + ext2fs was working again + <youpi> all that on the same machine with *no* system reboot + <youpi> just ext2fs restart :) + + +So if you want to [reason for contibuting to the Hurd], +please [[get in contact|contact_us]] -- and maybe already grab the [[source +code|source_repositories]]. + +--- + +The **GNU Hurd** is the GNU project's replacement for the Unix kernel. It is a +collection of servers that run on the Mach microkernel to implement file +systems, network protocols, file access control, and other features that are +implemented by the Unix kernel or similar kernels (such as Linux). [[More +detailed|hurd/documentation]]. + +**GNU Mach** is the microkernel upon which a GNU Hurd system is based. It +provides an Inter Process Communication (IPC) mechanism that the Hurd uses to +define interfaces for implementing in a distributed multi-server fashion the +services a traditional operating system kernel provides. [[More +detailed|microkernel/mach/gnumach]]. + +<!--see [[contributing/web_pages/news/writing_the_qoth]] for additional information on writing the QotH.--> + +"""]] diff --git a/contributing/web_pages/news/skeleton.mdwn b/contributing/web_pages/news/skeleton.mdwn new file mode 100644 index 00000000..bb39cd6e --- /dev/null +++ b/contributing/web_pages/news/skeleton.mdwn @@ -0,0 +1,60 @@ +[[!meta copyright="Copyright © 2012 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +<!-- Date when the news item is (to be) pulished (important for RSS feeds). +Will be set by tschwinge when publishing. +[[!meta date="YYYY-MM-DD HH:MM UTC"]] +--> + +<!-- This is just a skeleton. Use it to create a new QotH. --> + +A quarter of the Hurd, QN of YYYY: *TODO*, *TODO*, and *TODO*. +[[!if test="included()" then="""[[!toggle id=full_news +text="Details."]][[!toggleable id=full_news text="[[!paste id=full_news]]"]]""" +else=" +[[!paste id=full_news]]"]] + +[[!cut id="full_news" text=""" + +<!--basic structure of a QotH entry. Adapt, reduce and add points as needed. At the end, try to make the text flow as a unified whole.--> + +This quarter [hurd hacker] [item] + +Also … + +[our hackers] … + +Mainly thanks to … + +Additionally … + +And … + +So if you want to [reason for contibuting to the Hurd], +please [[get in contact|contact_us]] -- and maybe already grab the [[source +code|source_repositories]]. + +--- + +The **GNU Hurd** is the GNU project's replacement for the Unix kernel. It is a +collection of servers that run on the Mach microkernel to implement file +systems, network protocols, file access control, and other features that are +implemented by the Unix kernel or similar kernels (such as Linux). [[More +detailed|hurd/documentation]]. + +**GNU Mach** is the microkernel upon which a GNU Hurd system is based. It +provides an Inter Process Communication (IPC) mechanism that the Hurd uses to +define interfaces for implementing in a distributed multi-server fashion the +services a traditional operating system kernel provides. [[More +detailed|microkernel/mach/gnumach]]. + +<!--see [[contributing/web_pages/news/writing_the_qoth]] for additional information on writing the QotH.--> + +"""]] diff --git a/contributing/web_pages/news/writing_the_qoth.mdwn b/contributing/web_pages/news/writing_the_qoth.mdwn new file mode 100644 index 00000000..88542255 --- /dev/null +++ b/contributing/web_pages/news/writing_the_qoth.mdwn @@ -0,0 +1,79 @@ +[[!meta copyright="Copyright © 2010, 2011, 2012 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +# Short Guide for Writing the QotH + +The not yet published next Quarter of Hurd the can found at [[contributing/web_pages/news/qoth_next]]. + +## Individual News Items + +The basic structure for a news item is as follows: *\[person with](link) did +\[task with}(link to testable code/patch) which brings us further towards +\[[goal]] by [short, easily understandable description of the contribution]*. + +Each news item should show a step towards the mission of the Hurd. From +[[community/weblogs/antrik/hurd-mission-statement]] you can +glean the following basic goals: + + * Better support for day-to-day desktop use (more packages, more stable, more + drivers, easier to setup, ...). + * More user freedom and possibilities for programs/translators. + * Technical advancement. + * More unique or at least interesting features. + * Attract more developers and/or users. + +The reason for this structure is to resolve the problem that many people think +that the Hurd won't ever be finished by concentrating on the improvements and +the steps towards completing our mission -- but only once they have actually +been done (to avoid showing anything which might become vaporware). + + +## Sources for News Items + +Watch these places for news: + + * GNU + + * <http://lists.gnu.org/archive/html/bug-hurd/YYYY-MM/threads.html> + + * <http://lists.gnu.org/archive/html/commit-hurd/YYYY-MM/threads.html> + + * <http://lists.gnu.org/archive/html/help-hurd/YYYY-MM/threads.html> + + * <http://lists.gnu.org/archive/html/web-hurd/YYYY-MM/threads.html> + + * <http://lists.gnu.org/archive/html/hurd-devel/YYYY-MM/threads.html> + + * <http://sourceware.org/ml/libc-alpha/YYYY-MM/> + + Also Git log. + + * (<http://sourceware.org/ml/libc-hacker/YYYY-MM/>) + + * (<http://sourceware.org/ml/glibc-cvs/YYYY-qQ/>) + + Better use the Git log. + + * <http://lists.gnu.org/archive/html/l4-hurd/YYYY-MM/threads.html> + + * Debian + + * <http://lists.debian.org/debian-hurd/YYYY/MM/> + + * <http://lists.debian.org/debian-glibc/YYYY/MM/> + + * Arch Hurd + + * <http://www.archhurd.org/news.php> + + * <http://planet.archhurd.org/> + + * (<http://lists.archhurd.org/devel/maillist.html>) |