Rework introduction and remove changelog.

1 files changed, 8 insertions, 52 deletions

diff --git a/hurd/porting/guidelines.mdwn b/hurd/porting/guidelines.mdwn
index f37a17e2..b96df856 100644
--- a/hurd/porting/guidelines.mdwn
+++ b/hurd/porting/guidelines.mdwn
@@ -9,29 +9,19 @@ 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]]."]]"""]]
 
-## <a name="Table_of_Contents"> Table of Contents </a>
+This is a compilation of common porting problems and their solutions.
 
-%TOC%
 
-## <a name="Overview"> Overview </a>
+Additionally to this page, also see the section *General Porting Issues* of
+<http://www.debian.org/ports/hurd/hurd-devel-debian><!-- TODO: merge these two
+pages.  -->, as well as further Debian-specific [[running/debian/porting]]
+information.
 
-This is a recompilation of common porting problems and their solutions. Information is gathered from the following sources:
+There is a separate page about [[System_API_Limitations]].
 
-* [Debian GNU/Hurd port guidelines](http://www.debian.org/ports/hurd/hurd-devel-debian)
+You may ask on the [[mailing_lists/bug-hurd]] mailing list for details or
+questions about fixing bugs.
 
-* [James Morrison's GNU/Hurd pages](http://hurd.dyndns.org/)
-
-as well as other misc. sources.
-
-First of all, see [[BtsFiling]] if you need instructions on manipulating [Debian](http://www.debian.org/) source packages and submitting patches to their [Bug Tracking System](http://bugs.debian.org/).
-
-## <a name="System_API_limitations"> </a> System API limitations
-
-Sometimes building or running a program will fail due to bugs in the system API implementation (in Glibc and the Hurd). Make sure you check this list and know them before porting, otherwise you'll end up debugging something just to find out its an already known bug.
-
-We maintain a separate Wiki page for information on these bugs, see [[System_API_Limitations]]
-
-If you think you can fix any of them and send a patch to the debian BTS, that'd be much appreciated. You may ask in <bug-hurd@gnuNOSPAM.org> for details or questions on the bug.
 
 ## <a name="Undefined_bits_confname_h_tt_mac"> Undefined `bits/confname.h` macros (`PIPE_BUF`, ...) </a>
 
@@ -245,37 +235,3 @@ Not implemented, not POSIX.  Try to disable the feature in the package.
 ## <a name="broken_libc6_dependency"> broken libc6 dependency </a>
 
 Some packages use an erroneous dependency on `libc6-dev`. This is incorrect because `libc6` is specific to GNU/Linux. The corresponding package for GNU is `libc0.3-dev` but other OSes will have different ones. You can locate the problem in the `debian/control` file of the source tree. Typical solutions include detecting the OS using `dpkg-architecture` and hardcoding the soname, or better, use a logical OR. eg: `libc6-dev | libc0.3-dev | libc-dev`. The `libc-dev` is a virtual package that works for any soname but you have to put it only as the last option.
-
-----
-
-## <a name="ChangeLog"> ChangeLog </a>
-
--- [[Main/TWikiGuest]] - 13 Jan 2005
-
-Fix xgethostname example. - Neal
-
--- [[Main/RobertMillan]] - 22 Jul 2002
-
-Formatting and minor grammatical fixes.
-
--- [[Main/JoachimNilsson]] - 09 Sep 2002
-
-Added more examples and misc semantical fixes.
-
--- [[Main/RobertMillan]] - 05 Oct 2002
-
-Added `xgethostname` example.
-
--- [[Main/RobertMillan]] - 15 Nov 2002
-
-Added broken libc6 dependency
-
--- [[Main/RobertMillan]] - 21 Nov 2002
-
-Text formatting.
-
--- Ognyan Kulev - 12 Mar 2003
-
-Added `ioctl` entry.
-
--- [[Main/RobertMillan]] - 19 Mar 2003