| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
| 1 | <!-- $NetBSD: components.xml,v 1.54 2017/01/25 20:10:46 leot Exp $ --> | | 1 | <!-- $NetBSD: components.xml,v 1.55 2018/07/24 23:46:15 maya Exp $ --> |
| 2 | | | 2 | |
| 3 | <chapter id="components"> <?dbhtml filename="components.html"?> | | 3 | <chapter id="components"> <?dbhtml filename="components.html"?> |
| 4 | <title>Package components - files, directories and contents</title> | | 4 | <title>Package components - files, directories and contents</title> |
| 5 | | | 5 | |
| 6 | <para>Whenever you're preparing a package, there are a number of | | 6 | <para>Whenever you're preparing a package, there are a number of |
| 7 | files involved which are described in the following | | 7 | files involved which are described in the following |
| 8 | sections.</para> | | 8 | sections.</para> |
| 9 | | | 9 | |
| 10 | <sect1 id="components.Makefile"> | | 10 | <sect1 id="components.Makefile"> |
| 11 | <title><filename>Makefile</filename></title> | | 11 | <title><filename>Makefile</filename></title> |
| 12 | | | 12 | |
| 13 | <para>Building, installation and creation of a binary package are all | | 13 | <para>Building, installation and creation of a binary package are all |
| 14 | controlled by the package's <filename>Makefile</filename>. | | 14 | controlled by the package's <filename>Makefile</filename>. |
| @@ -439,37 +439,26 @@ monitor_file(...) | | | @@ -439,37 +439,26 @@ monitor_file(...) |
| 439 | #if defined(HAVE_KQUEUE) | | 439 | #if defined(HAVE_KQUEUE) |
| 440 | int fd = kqueue(); | | 440 | int fd = kqueue(); |
| 441 | ... | | 441 | ... |
| 442 | #else | | 442 | #else |
| 443 | ... | | 443 | ... |
| 444 | #endif | | 444 | #endif |
| 445 | } | | 445 | } |
| 446 | </programlisting> | | 446 | </programlisting> |
| 447 | </entry> | | 447 | </entry> |
| 448 | </row> | | 448 | </row> |
| 449 | </tbody> | | 449 | </tbody> |
| 450 | </tgroup> | | 450 | </tgroup> |
| 451 | </table> | | 451 | </table> |
| 452 | | | | |
| 453 | <para>For more information, please read the <emphasis>Making | | | |
| 454 | packager-friendly software</emphasis> article (<ulink | | | |
| 455 | url="http://www.onlamp.com/pub/a/onlamp/2005/03/31/packaging.html">part | | | |
| 456 | 1</ulink>, <ulink | | | |
| 457 | url="http://www.oreillynet.com/pub/a/onlamp/2005/04/28/packaging2.html">part | | | |
| 458 | 2</ulink>). It summarizes multiple details on how to make | | | |
| 459 | software easier to package; all the suggestions in it were | | | |
| 460 | collected from our experience in pkgsrc work, so they are possibly | | | |
| 461 | helpful when creating patches too.</para> | | | |
| 462 | | | | |
| 463 | </sect2> | | 452 | </sect2> |
| 464 | | | 453 | |
| 465 | <sect2 id="components.patches.feedback"> | | 454 | <sect2 id="components.patches.feedback"> |
| 466 | <title>Feedback to the author</title> | | 455 | <title>Feedback to the author</title> |
| 467 | | | 456 | |
| 468 | <para>Always, always, <emphasis role="strong">always</emphasis> | | 457 | <para>Always, always, <emphasis role="strong">always</emphasis> |
| 469 | feed back any <emphasis>portability fixes</emphasis> or | | 458 | feed back any <emphasis>portability fixes</emphasis> or |
| 470 | improvements you do to a package to the mainstream developers. | | 459 | improvements you do to a package to the mainstream developers. |
| 471 | This is the only way to get their attention on portability issues | | 460 | This is the only way to get their attention on portability issues |
| 472 | and to ensure that future versions can be built out-of-the box on | | 461 | and to ensure that future versions can be built out-of-the box on |
| 473 | NetBSD. Furthermore, any user that gets newer distfiles will get | | 462 | NetBSD. Furthermore, any user that gets newer distfiles will get |
| 474 | the fixes straight from the packaged code.</para> | | 463 | the fixes straight from the packaged code.</para> |
| 475 | | | 464 | |