summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Schwinge <tschwinge@gnu.org>2009-04-05 19:11:59 +0200
committerThomas Schwinge <tschwinge@gnu.org>2009-04-05 19:13:12 +0200
commit661c83c479f13d8e7c1e5d52946a7cce19b0a67f (patch)
tree31bf375dfe2d638577377621724a47015c095b6f
parent5fb5cd59948b112aaaaa24c406bc1fe7f31a0382 (diff)
Rework introduction and remove changelog.
-rw-r--r--hurd/porting/guidelines.mdwn60
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