| | | |
Offset 1529, 30 lines modified | Offset 1529, 30 lines modified |
1529 | \xcDebian·Policy·Manual,·Release·4.7.2.0 | 1529 | \xcDebian·Policy·Manual,·Release·4.7.2.0 |
| |
1530 | 4.2·Package·relationships | 1530 | 4.2·Package·relationships |
1531 | Source·packages·should·specify·which·binary·packages·they·require·to·be·installed·or·not·to·be·installed·in·order·to·build | 1531 | Source·packages·should·specify·which·binary·packages·they·require·to·be·installed·or·not·to·be·installed·in·order·to·build |
1532 | correctly.·For·example,·if·building·a·package·requires·a·certain·compiler,·then·the·compiler·should·be·specified·as·a | 1532 | correctly.·For·example,·if·building·a·package·requires·a·certain·compiler,·then·the·compiler·should·be·specified·as·a |
1533 | build-time·dependency. | 1533 | build-time·dependency. |
1534 | It·is·not·necessary·to·explicitly·specify·build-time·relationships·on·a·minimal·set·of·packages·that·are·always·needed | 1534 | It·is·not·necessary·to·explicitly·specify·build-time·relationships·on·a·minimal·set·of·packages·that·are·always·needed |
1535 | to·compile,·link·and·put·in·a·Debian·package·a·standard·“Hello·World!”·program·written·in·C·or·C++.·The·required | 1535 | to·compile,·link·and·put·in·a·Debian·package·a·standard·"Hello·World!"·program·written·in·C·or·C++.·The·required |
1536 | packages·are·called·build-essential,·and·an·informational·list·can·be·found·in·/usr/share/doc/build-essential/ | 1536 | packages·are·called·build-essential,·and·an·informational·list·can·be·found·in·/usr/share/doc/build-essential/ |
1537 | list·(which·is·contained·in·the·build-essential·package).1 | 1537 | list·(which·is·contained·in·the·build-essential·package).1 |
1538 | When·specifying·the·set·of·build-time·dependencies,·one·should·list·only·those·packages·explicitly·required·by·the·build. | 1538 | When·specifying·the·set·of·build-time·dependencies,·one·should·list·only·those·packages·explicitly·required·by·the·build. |
1539 | It·is·not·necessary·to·list·packages·which·are·required·merely·because·some·other·package·in·the·list·of·build-time·dependencies·depends·on·them.2 | 1539 | It·is·not·necessary·to·list·packages·which·are·required·merely·because·some·other·package·in·the·list·of·build-time·dependencies·depends·on·them.2 |
1540 | If·build-time·dependencies·are·specified,·it·must·be·possible·to·build·the·package·and·produce·working·binaries·on·a·system | 1540 | If·build-time·dependencies·are·specified,·it·must·be·possible·to·build·the·package·and·produce·working·binaries·on·a·system |
1541 | with·only·essential·and·build-essential·packages·installed·and·also·those·required·to·satisfy·the·build-time·relationships | 1541 | with·only·essential·and·build-essential·packages·installed·and·also·those·required·to·satisfy·the·build-time·relationships |
1542 | (including·any·implied·relationships).·In·particular,·this·means·that·version·clauses·should·be·used·rigorously·in·build-time | 1542 | (including·any·implied·relationships).·In·particular,·this·means·that·version·clauses·should·be·used·rigorously·in·build-time |
1543 | relationships·so·that·one·cannot·produce·bad·or·inconsistently·configured·packages·when·the·relationships·are·properly | 1543 | relationships·so·that·one·cannot·produce·bad·or·inconsistently·configured·packages·when·the·relationships·are·properly |
1544 | satisfied. | 1544 | satisfied. |
1545 | Declaring·relationships·between·packages·explains·the·technical·details. | 1545 | Declaring·relationships·between·packages·explains·the·technical·details. |
| |
1546 | 4.3·Changes·to·the·upstream·sources | 1546 | 4.3·Changes·to·the·upstream·sources |
1547 | If·changes·to·the·source·code·are·made·that·are·not·specific·to·the·needs·of·the·Debian·system,·they·should·be·sent·to·the | 1547 | If·changes·to·the·source·code·are·made·that·are·not·specific·to·the·needs·of·the·Debian·system,·they·should·be·sent·to·the |
1548 | upstream·authors·in·whatever·form·they·prefer·so·as·to·be·included·in·the·upstream·version·of·the·package. | 1548 | upstream·authors·in·whatever·form·they·prefer·so·as·to·be·included·in·the·upstream·version·of·the·package. |
1549 | If·you·need·to·configure·the·package·differently·for·Debian·or·for·Linux,·and·the·upstream·source·doesn’t·provide·a·way | 1549 | If·you·need·to·configure·the·package·differently·for·Debian·or·for·Linux,·and·the·upstream·source·doesn't·provide·a·way |
1550 | to·do·so,·you·should·add·such·configuration·facilities·(for·example,·a·new·autoconf·test·or·#define)·and·send·the·patch | 1550 | to·do·so,·you·should·add·such·configuration·facilities·(for·example,·a·new·autoconf·test·or·#define)·and·send·the·patch |
1551 | to·the·upstream·authors,·with·the·default·set·to·the·way·they·originally·had·it.·You·can·then·easily·override·the·default·in | 1551 | to·the·upstream·authors,·with·the·default·set·to·the·way·they·originally·had·it.·You·can·then·easily·override·the·default·in |
1552 | your·debian/rules·or·wherever·is·appropriate. | 1552 | your·debian/rules·or·wherever·is·appropriate. |
1553 | You·should·make·sure·that·the·configure·utility·detects·the·correct·architecture·specification·string·(refer·to·Architecture | 1553 | You·should·make·sure·that·the·configure·utility·detects·the·correct·architecture·specification·string·(refer·to·Architecture |
1554 | specification·strings·for·details). | 1554 | specification·strings·for·details). |
1555 | If·your·package·includes·the·scripts·config.sub·and·config.guess,·you·should·arrange·for·the·versions·provided·by | 1555 | If·your·package·includes·the·scripts·config.sub·and·config.guess,·you·should·arrange·for·the·versions·provided·by |
1556 | the·package·autotools-dev·be·used·instead·(see·autotools-dev·documentation·for·details·how·to·achieve·that).·This·ensures | 1556 | the·package·autotools-dev·be·used·instead·(see·autotools-dev·documentation·for·details·how·to·achieve·that).·This·ensures |
Offset 1607, 30 lines modified | Offset 1607, 30 lines modified |
1607 | of·this·package·into·the·Debian·archive·by·including·the·string:·closes:·Bug#nnnnn·in·the·change·details,·where | 1607 | of·this·package·into·the·Debian·archive·by·including·the·string:·closes:·Bug#nnnnn·in·the·change·details,·where |
1608 | #nnnnn·is·the·bug·number.5·This·information·is·conveyed·via·the·Closes·field·in·the·.changes·file·(see·Closes). | 1608 | #nnnnn·is·the·bug·number.5·This·information·is·conveyed·via·the·Closes·field·in·the·.changes·file·(see·Closes). |
1609 | The·maintainer·name·and·email·address·used·in·the·changelog·should·be·the·details·of·the·person·who·prepared·this | 1609 | The·maintainer·name·and·email·address·used·in·the·changelog·should·be·the·details·of·the·person·who·prepared·this |
1610 | release·of·the·package.·They·are·not·necessarily·those·of·the·uploader·or·usual·package·maintainer.6·The·information | 1610 | release·of·the·package.·They·are·not·necessarily·those·of·the·uploader·or·usual·package·maintainer.6·The·information |
1611 | here·will·be·copied·to·the·Changed-By·field·in·the·.changes·file·(see·Changed-By),·and·then·later·used·to·send·an | 1611 | here·will·be·copied·to·the·Changed-By·field·in·the·.changes·file·(see·Changed-By),·and·then·later·used·to·send·an |
1612 | acknowledgement·when·the·upload·has·been·installed. | 1612 | acknowledgement·when·the·upload·has·been·installed. |
1613 | The·date·has·the·following·format7·(compatible·and·with·the·same·semantics·of·RFC·2822·and·RFC·5322): | 1613 | The·date·has·the·following·format7·(compatible·and·with·the·same·semantics·of·RFC·2822·and·RFC·5322): |
1614 | 3·Mistakes·in·changelogs·are·usually·best·rectified·by·making·a·new·changelog·entry·rather·than·“rewriting·history”·by·editing·old·changelog·entries. | 1614 | 3·Mistakes·in·changelogs·are·usually·best·rectified·by·making·a·new·changelog·entry·rather·than·"rewriting·history"·by·editing·old·changelog·entries. |
1615 | 4·Although·there·is·nothing·stopping·an·author·who·is·also·the·Debian·maintainer·from·using·this·changelog·for·all·their·changes,·it·will·have·to·be | 1615 | 4·Although·there·is·nothing·stopping·an·author·who·is·also·the·Debian·maintainer·from·using·this·changelog·for·all·their·changes,·it·will·have·to·be |
1616 | renamed·if·the·Debian·and·upstream·maintainers·become·different·people.·In·such·a·case,·however,·it·might·be·better·to·maintain·the·package·as·a | 1616 | renamed·if·the·Debian·and·upstream·maintainers·become·different·people.·In·such·a·case,·however,·it·might·be·better·to·maintain·the·package·as·a |
1617 | non-native·package. | 1617 | non-native·package. |
1618 | 5·To·be·precise,·the·string·should·match·the·following·Perl·regular·expression: | 1618 | 5·To·be·precise,·the·string·should·match·the·following·Perl·regular·expression: |
| |
1619 | /closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i | 1619 | /closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i |
| |
1620 | That·is:·The·string·should·consist·of·the·word·closes:·followed·by·a·comma-separated·list·of·bug·numbers.·Bug·numbers·may·be·preceded·by·the | 1620 | That·is:·The·string·should·consist·of·the·word·closes:·followed·by·a·comma-separated·list·of·bug·numbers.·Bug·numbers·may·be·preceded·by·the |
1621 | word·bug·and/or·a·#·sign,·as·in·Closes:·42,·bug#43,·#44,·bug·45. | 1621 | word·bug·and/or·a·#·sign,·as·in·Closes:·42,·bug#43,·#44,·bug·45. |
1622 | The·list·of·bug·numbers·may·span·multiple·lines. | 1622 | The·list·of·bug·numbers·may·span·multiple·lines. |
1623 | All·of·the·bug·numbers·listed·will·be·closed·by·the·archive·maintenance·software·(dak)·using·the·version·of·the·changelog·entry. | 1623 | All·of·the·bug·numbers·listed·will·be·closed·by·the·archive·maintenance·software·(dak)·using·the·version·of·the·changelog·entry. |
1624 | The·words·closes:·and·bug·are·not·case·sensitive. | 1624 | The·words·closes:·and·bug·are·not·case·sensitive. |
1625 | 6·In·the·case·of·a·sponsored·upload,·the·uploader·signs·the·files,·but·the·changelog·maintainer·name·and·address·are·those·of·the·person·who·prepared | 1625 | 6·In·the·case·of·a·sponsored·upload,·the·uploader·signs·the·files,·but·the·changelog·maintainer·name·and·address·are·those·of·the·person·who·prepared |
1626 | this·release.·If·the·preparer·of·the·release·is·not·one·of·the·usual·maintainers·of·the·package·(as·listed·in·the·Maintainer·or·Uploaders·control·fields·of | 1626 | this·release.·If·the·preparer·of·the·release·is·not·one·of·the·usual·maintainers·of·the·package·(as·listed·in·the·Maintainer·or·Uploaders·control·fields·of |
1627 | the·package),·the·first·line·of·the·changelog·is·conventionally·used·to·explain·why·a·non-maintainer·is·uploading·the·package.·The·Debian·Developer’s | 1627 | the·package),·the·first·line·of·the·changelog·is·conventionally·used·to·explain·why·a·non-maintainer·is·uploading·the·package.·The·Debian·Developer's |
1628 | Reference·(see·Related·documents)·documents·the·conventions·used. | 1628 | Reference·(see·Related·documents)·documents·the·conventions·used. |
1629 | 7·This·is·the·same·as·the·format·generated·by·date·-R. | 1629 | 7·This·is·the·same·as·the·format·generated·by·date·-R. |
| |
1630 | 4.4.·Debian·changelog:·debian/changelog | 1630 | 4.4.·Debian·changelog:·debian/changelog |
| |
1631 | 21 | 1631 | 21 |
| |
Offset 1643, 40 lines modified | Offset 1643, 40 lines modified |
1643 | •·dd·is·a·one-·or·two-digit·day·of·the·month·(01-31) | 1643 | •·dd·is·a·one-·or·two-digit·day·of·the·month·(01-31) |
1644 | •·month·is·one·of:·Jan,·Feb,·Mar,·Apr,·May,·Jun,·Jul,·Aug,·Sep,·Oct,·Nov,·Dec | 1644 | •·month·is·one·of:·Jan,·Feb,·Mar,·Apr,·May,·Jun,·Jul,·Aug,·Sep,·Oct,·Nov,·Dec |
1645 | •·yyyy·is·the·four-digit·year·(e.g.·2010) | 1645 | •·yyyy·is·the·four-digit·year·(e.g.·2010) |
1646 | •·hh·is·the·two-digit·hour·(00-23) | 1646 | •·hh·is·the·two-digit·hour·(00-23) |
1647 | •·mm·is·the·two-digit·minutes·(00-59) | 1647 | •·mm·is·the·two-digit·minutes·(00-59) |
1648 | •·ss·is·the·two-digit·seconds·(00-60) | 1648 | •·ss·is·the·two-digit·seconds·(00-60) |
1649 | •·+zzzz·or·-zzzz·is·the·time·zone·offset·from·Coordinated | 1649 | •·+zzzz·or·-zzzz·is·the·time·zone·offset·from·Coordinated |
1650 | Universal·Time·(UTC).·“+”·indicates·that·the·time·is·ahead·of·(i.e.,·east·of)·UTC·and·“-”·indicates·that·the | 1650 | Universal·Time·(UTC).·"+"·indicates·that·the·time·is·ahead·of·(i.e.,·east·of)·UTC·and·"-"·indicates·that·the |
1651 | time·is·behind·(i.e.,·west·of)·UTC.·The·first·two·digits·indicate·the·hour·difference·from·UTC·and·the·last | 1651 | time·is·behind·(i.e.,·west·of)·UTC.·The·first·two·digits·indicate·the·hour·difference·from·UTC·and·the·last |
1652 | two·digits·indicate·the·number·of·additional·minutes·difference·from·UTC.·The·last·two·digits·must·be·in·the | 1652 | two·digits·indicate·the·number·of·additional·minutes·difference·from·UTC.·The·last·two·digits·must·be·in·the |
1653 | range·00-59. | 1653 | range·00-59. |
1654 | The·first·“title”·line·with·the·package·name·must·start·at·the·left·hand·margin.·The·“trailer”·line·with·the·maintainer·and | 1654 | The·first·"title"·line·with·the·package·name·must·start·at·the·left·hand·margin.·The·"trailer"·line·with·the·maintainer·and |
1655 | date·details·must·be·preceded·by·exactly·one·space.·The·maintainer·details·and·the·date·must·be·separated·by·exactly·two | 1655 | date·details·must·be·preceded·by·exactly·one·space.·The·maintainer·details·and·the·date·must·be·separated·by·exactly·two |
1656 | spaces. | 1656 | spaces. |
1657 | The·entire·changelog·must·be·encoded·in·UTF-8. | 1657 | The·entire·changelog·must·be·encoded·in·UTF-8. |
1658 | For·more·information·on·placement·of·the·changelog·files·within·binary·packages,·please·see·Changelog·files·and·release | 1658 | For·more·information·on·placement·of·the·changelog·files·within·binary·packages,·please·see·Changelog·files·and·release |
1659 | notes. | 1659 | notes. |
| |
1660 | 4.5·Copyright:·debian/copyright | 1660 | 4.5·Copyright:·debian/copyright |
1661 | Every·package·must·be·accompanied·by·a·verbatim·copy·of·its·distribution·license(s)·in·the·file·/usr/share/doc/ | 1661 | Every·package·must·be·accompanied·by·a·verbatim·copy·of·its·distribution·license(s)·in·the·file·/usr/share/doc/ |
1662 | PACKAGE/copyright. | 1662 | PACKAGE/copyright. |
1663 | This·file·is·often·required·to·contain·a·verbatim·copy·of·the·package’s·copyright·information,·too;·see·Copyright·information | 1663 | This·file·is·often·required·to·contain·a·verbatim·copy·of·the·package's·copyright·information,·too;·see·Copyright·information |
1664 | and·Copyright·considerations·for·details,·and·for·further·considerations·related·to·copyrights·for·packages. | 1664 | and·Copyright·considerations·for·details,·and·for·further·considerations·related·to·copyrights·for·packages. |
| |
1665 | 4.6·Error·trapping·in·makefiles | 1665 | 4.6·Error·trapping·in·makefiles |
1666 | When·make·invokes·a·command·in·a·makefile·(including·your·package’s·upstream·makefiles·and·debian/rules),·it | 1666 | When·make·invokes·a·command·in·a·makefile·(including·your·package's·upstream·makefiles·and·debian/rules),·it |
1667 | does·so·using·sh.·This·means·that·sh’s·usual·bad·error·handling·properties·apply:·if·you·include·a·miniature·script·as·one | 1667 | does·so·using·sh.·This·means·that·sh's·usual·bad·error·handling·properties·apply:·if·you·include·a·miniature·script·as·one |
1668 | of·the·commands·in·your·makefile·you’ll·find·that·if·you·don’t·do·anything·about·it·then·errors·are·not·detected·and·make | 1668 | of·the·commands·in·your·makefile·you'll·find·that·if·you·don't·do·anything·about·it·then·errors·are·not·detected·and·make |
1669 | will·blithely·continue·after·problems. | 1669 | will·blithely·continue·after·problems. |
1670 | Every·time·you·put·more·than·one·shell·command·(this·includes·using·a·loop)·in·a·makefile·command·you·must·make | 1670 | Every·time·you·put·more·than·one·shell·command·(this·includes·using·a·loop)·in·a·makefile·command·you·must·make |
1671 | sure·that·errors·are·trapped.·For·simple·compound·commands,·such·as·changing·directory·and·then·running·a·program, | 1671 | sure·that·errors·are·trapped.·For·simple·compound·commands,·such·as·changing·directory·and·then·running·a·program, |
1672 | using·&&·rather·than·semicolon·as·a·command·separator·is·sufficient.·For·more·complex·commands·including·most·loops | 1672 | using·&&·rather·than·semicolon·as·a·command·separator·is·sufficient.·For·more·complex·commands·including·most·loops |
1673 | and·conditionals·you·should·include·a·separate·set·-e·command·at·the·start·of·every·makefile·command·that’s·actually | 1673 | and·conditionals·you·should·include·a·separate·set·-e·command·at·the·start·of·every·makefile·command·that's·actually |
1674 | one·of·these·miniature·shell·scripts. | 1674 | one·of·these·miniature·shell·scripts. |
| |
1675 | 22 | 1675 | 22 |
| |
1676 | Chapter·4.·Source·packages | 1676 | Chapter·4.·Source·packages |
| |
1677 | \xcDebian·Policy·Manual,·Release·4.7.2.0 | 1677 | \xcDebian·Policy·Manual,·Release·4.7.2.0 |
Offset 1788, 29 lines modified | Offset 1788, 29 lines modified |
1788 | \xcDebian·Policy·Manual,·Release·4.7.2.0 | 1788 | \xcDebian·Policy·Manual,·Release·4.7.2.0 |
| |
1789 | clean·(required) | 1789 | clean·(required) |
| |
1790 | This·must·undo·any·effects·that·the·build·and·binary·targets·may·have·had,·except·that·it·should·leave·alone·any | 1790 | This·must·undo·any·effects·that·the·build·and·binary·targets·may·have·had,·except·that·it·should·leave·alone·any |
1791 | output·files·created·in·the·parent·directory·by·a·run·of·a·binary·target. | 1791 | output·files·created·in·the·parent·directory·by·a·run·of·a·binary·target. |
1792 | If·a·build·file·is·touched·at·the·end·of·the·build·target,·as·suggested·above,·it·should·be·removed·as·the·first | 1792 | If·a·build·file·is·touched·at·the·end·of·the·build·target,·as·suggested·above,·it·should·be·removed·as·the·first |
1793 | action·that·clean·performs,·so·that·running·build·again·after·an·interrupted·clean·doesn’t·think·that·everything | 1793 | action·that·clean·performs,·so·that·running·build·again·after·an·interrupted·clean·doesn't·think·that·everything |
1794 | is·already·done. | 1794 | is·already·done. |
1795 | The·clean·target·may·need·to·be·invoked·as·root·if·binary·has·been·invoked·since·the·last·clean,·or·if·build | 1795 | The·clean·target·may·need·to·be·invoked·as·root·if·binary·has·been·invoked·since·the·last·clean,·or·if·build |
1796 | has·been·invoked·as·root·(since·build·may·create·directories,·for·example). | 1796 | has·been·invoked·as·root·(since·build·may·create·directories,·for·example). |
1797 | The·clean·target·cannot·be·used·to·remove·files·in·the·source·tree·that·are·not·compatible·with·the·DFSG.·This | 1797 | The·clean·target·cannot·be·used·to·remove·files·in·the·source·tree·that·are·not·compatible·with·the·DFSG.·This |
1798 | is·because·the·files·would·remain·in·the·upstream·tarball,·and·thus·in·the·source·package,·so·the·source·package | 1798 | is·because·the·files·would·remain·in·the·upstream·tarball,·and·thus·in·the·source·package,·so·the·source·package |
1799 | would·continue·to·violate·DFSG.·Instead,·the·upstream·source·should·be·repacked·to·remove·those·files. | 1799 | would·continue·to·violate·DFSG.·Instead,·the·upstream·source·should·be·repacked·to·remove·those·files. |
1800 | patch·(optional) | 1800 | patch·(optional) |
| |
1801 | This·target·performs·whatever·additional·actions·are·required·to·make·the·source·ready·for·editing·(unpacking | 1801 | This·target·performs·whatever·additional·actions·are·required·to·make·the·source·ready·for·editing·(unpacking |
1802 | additional·upstream·archives,·applying·patches,·etc.).·It·is·recommended·to·be·implemented·for·any·package | 1802 | additional·upstream·archives,·applying·patches,·etc.).·It·is·recommended·to·be·implemented·for·any·package |
1803 | where·dpkg-source·-x·does·not·result·in·source·ready·for·additional·modification.·See·Source·package·handling: | 1803 | where·dpkg-source·-x·does·not·result·in·source·ready·for·additional·modification.·See·Source·package·handling: |
1804 | debian/README.source. | 1804 | debian/README.source. |
1805 | The·build,·binary·and·clean·targets·must·be·invoked·with·the·current·directory·being·the·package’s·top-level·directory. | 1805 | The·build,·binary·and·clean·targets·must·be·invoked·with·the·current·directory·being·the·package's·top-level·directory. |
1806 | Additional·targets·may·exist·in·debian/rules,·either·as·published·or·undocumented·interfaces·or·for·the·package’s | 1806 | Additional·targets·may·exist·in·debian/rules,·either·as·published·or·undocumented·interfaces·or·for·the·package's |
1807 | internal·use. | 1807 | internal·use. |
1808 | The·architectures·we·build·on·and·build·for·are·determined·by·make·variables·using·the·utility·dpkg-architecture. | 1808 | The·architectures·we·build·on·and·build·for·are·determined·by·make·variables·using·the·utility·dpkg-architecture. |
Max diff block lines reached; 55445/66779 bytes (83.03%) of diff not shown.
|