dpkg-scansources.8 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279
  1. .rn '' }`
  2. ''' $RCSfile$$Revision$$Date$
  3. '''
  4. ''' $Log$
  5. ''' Revision 1.1 2001-04-24 12:45:29 wakkerma
  6. ''' Move dpkg-scansources manpage to section 8
  7. '''
  8. ''' Revision 1.1 2001/03/05 15:37:51 wakkerma
  9. ''' French translation update
  10. '''
  11. ''' Revision 1.1 1999/09/27 01:00:50 wakkerma
  12. ''' Added some missing files
  13. '''
  14. ''' Revision 1.1 1999/03/21 22:45:17 maor
  15. ''' manpage
  16. '''
  17. '''
  18. .de Sh
  19. .br
  20. .if t .Sp
  21. .ne 5
  22. .PP
  23. \fB\\$1\fR
  24. .PP
  25. ..
  26. .de Sp
  27. .if t .sp .5v
  28. .if n .sp
  29. ..
  30. .de Ip
  31. .br
  32. .ie \\n(.$>=3 .ne \\$3
  33. .el .ne 3
  34. .IP "\\$1" \\$2
  35. ..
  36. .de Vb
  37. .ft CW
  38. .nf
  39. .ne \\$1
  40. ..
  41. .de Ve
  42. .ft R
  43. .fi
  44. ..
  45. '''
  46. '''
  47. ''' Set up \*(-- to give an unbreakable dash;
  48. ''' string Tr holds user defined translation string.
  49. ''' Bell System Logo is used as a dummy character.
  50. '''
  51. .tr \(*W-|\(bv\*(Tr
  52. .ie n \{\
  53. .ds -- \(*W-
  54. .ds PI pi
  55. .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  56. .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  57. .ds L" ""
  58. .ds R" ""
  59. ''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
  60. ''' \*(L" and \*(R", except that they are used on ".xx" lines,
  61. ''' such as .IP and .SH, which do another additional levels of
  62. ''' double-quote interpretation
  63. .ds M" """
  64. .ds S" """
  65. .ds N" """""
  66. .ds T" """""
  67. .ds L' '
  68. .ds R' '
  69. .ds M' '
  70. .ds S' '
  71. .ds N' '
  72. .ds T' '
  73. 'br\}
  74. .el\{\
  75. .ds -- \(em\|
  76. .tr \*(Tr
  77. .ds L" ``
  78. .ds R" ''
  79. .ds M" ``
  80. .ds S" ''
  81. .ds N" ``
  82. .ds T" ''
  83. .ds L' `
  84. .ds R' '
  85. .ds M' `
  86. .ds S' '
  87. .ds N' `
  88. .ds T' '
  89. .ds PI \(*p
  90. 'br\}
  91. .\" If the F register is turned on, we'll generate
  92. .\" index entries out stderr for the following things:
  93. .\" TH Title
  94. .\" SH Header
  95. .\" Sh Subsection
  96. .\" Ip Item
  97. .\" X<> Xref (embedded
  98. .\" Of course, you have to process the output yourself
  99. .\" in some meaninful fashion.
  100. .if \nF \{
  101. .de IX
  102. .tm Index:\\$1\t\\n%\t"\\$2"
  103. ..
  104. .nr % 0
  105. .rr F
  106. .\}
  107. .TH DPKG-SCANSOURCES 1 "perl 5.004, patch 04" "28/Feb/99" "User Contributed Perl Documentation"
  108. .UC
  109. .if n .hy 0
  110. .if n .na
  111. .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  112. .de CQ \" put $1 in typewriter font
  113. .ft CW
  114. 'if n "\c
  115. 'if t \\&\\$1\c
  116. 'if n \\&\\$1\c
  117. 'if n \&"
  118. \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
  119. '.ft R
  120. ..
  121. .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
  122. . \" AM - accent mark definitions
  123. .bd B 3
  124. . \" fudge factors for nroff and troff
  125. .if n \{\
  126. . ds #H 0
  127. . ds #V .8m
  128. . ds #F .3m
  129. . ds #[ \f1
  130. . ds #] \fP
  131. .\}
  132. .if t \{\
  133. . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  134. . ds #V .6m
  135. . ds #F 0
  136. . ds #[ \&
  137. . ds #] \&
  138. .\}
  139. . \" simple accents for nroff and troff
  140. .if n \{\
  141. . ds ' \&
  142. . ds ` \&
  143. . ds ^ \&
  144. . ds , \&
  145. . ds ~ ~
  146. . ds ? ?
  147. . ds ! !
  148. . ds /
  149. . ds q
  150. .\}
  151. .if t \{\
  152. . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  153. . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  154. . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  155. . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  156. . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  157. . ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
  158. . ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
  159. . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  160. . ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
  161. .\}
  162. . \" troff and (daisy-wheel) nroff accents
  163. .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  164. .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
  165. .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
  166. .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
  167. .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
  168. .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
  169. .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
  170. .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
  171. .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
  172. .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
  173. .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
  174. .ds ae a\h'-(\w'a'u*4/10)'e
  175. .ds Ae A\h'-(\w'A'u*4/10)'E
  176. .ds oe o\h'-(\w'o'u*4/10)'e
  177. .ds Oe O\h'-(\w'O'u*4/10)'E
  178. . \" corrections for vroff
  179. .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
  180. .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
  181. . \" for low resolution devices (crt and lpr)
  182. .if \n(.H>23 .if \n(.V>19 \
  183. \{\
  184. . ds : e
  185. . ds 8 ss
  186. . ds v \h'-1'\o'\(aa\(ga'
  187. . ds _ \h'-1'^
  188. . ds . \h'-1'.
  189. . ds 3 3
  190. . ds o a
  191. . ds d- d\h'-1'\(ga
  192. . ds D- D\h'-1'\(hy
  193. . ds th \o'bp'
  194. . ds Th \o'LP'
  195. . ds ae ae
  196. . ds Ae AE
  197. . ds oe oe
  198. . ds Oe OE
  199. .\}
  200. .rm #[ #] #H #V #F C
  201. .SH "NOM"
  202. dpkg-scansources \- prog
  203. .SH "SYNOPSIS"
  204. \fBdpkg-scansources\fR [switch]... \fIrep-de-binaires\fR [\fIfichier-d'-override\fR [\fIchemin-à-préfixer\fR]] > Sources
  205. .SH "DESCRIPTION"
  206. \fBdpkg-scansources\fR recherche les fichiers \fI.dsc\fR dans le répertoire
  207. \fIrep-de-binaires\fR donné.
  208. Ces fichiers servent à construire un index des sources Debian, lequel est
  209. envoyé sur la sortie standard.
  210. .PP
  211. Quand le fichier \fIfichier-d'-override\fR existe, il sert à fixer les
  212. priorités des enregistrements pour l'index qui est construit et à remplacer
  213. les champs «\ maintainer\ » donnés dans les fichiers \fI.dsc\fR. Voyez la
  214. page de manuel \fIdpkg-scanpackages\fR pour connaître le format de ce fichier.
  215. NB : le fichier \fIfichier-d'-override\fR étant indexé par paquets binaires
  216. et non par paquets sources, il y a un petit problème ! Parmi tous les paquets
  217. binaires produits par un fichier \fI.dsc\fR, l'implémentation actuelle
  218. affecte la priorité la plus élevée au paquet source ; et elle se sert de
  219. l'entrée « override » du premier paquet binaire listé dans
  220. le fichier \fI.dsc\fR pour modifier l'information sur le responsable du
  221. paquet. Cela pourrait changer.
  222. .PP
  223. Quand \fIchemin-à-préfixer\fR existe, il est préfixé au champ répertoire dans
  224. l'index produit pour le source. On s'en sert communément pour ajouter
  225. au champ répertoire le chemin indiquant la racine de l'archive Debian.
  226. .SH "OPTIONS"
  227. .Ip "\fB--debug\fR" 4
  228. demande le débogage.
  229. .Ip "\fB--help\fR" 4
  230. Affiche une aide pour l'utilisation et se termine.
  231. .Ip "\fB\-n\fR, \fB--no-sort\fR" 4
  232. Ne pas trier les enregistrements de l'index. Normalement, ils sont triés selon
  233. les noms des paquets source.
  234. .Ip "\fB\-s\fR, \fB--source-override\fR \fIfichier\fR" 4
  235. Utiliser \fIfichier\fR comme le fichier source d'« override ». Par défaut
  236. c'est le nom du fichier « override » indiqué auquel on
  237. ajoute \fI.src\fR.
  238. .Sp
  239. Le format du fichier source d'« override » diffère de celui du fichier binaire.
  240. Il contient seulement deux champs séparés par un espace : le premier est le nom
  241. du paquet source et le second la section. Lignes vides et commentaires sont
  242. ignorés. Quand un paquet apparaît dans les deux fichiers, le
  243. fichier source d'« override » décide du choix de la section.
  244. .Ip "\fB--version\fR" 4
  245. Affiche le numéro de la version et se termine.
  246. .SH "VOYEZ AUSSI"
  247. dpkg-\fIscanpackages\fR\|(8)
  248. .SH "AUTEUR"
  249. Roderick Schertler <roderick@argon.org>
  250. .SH "TRADUCTION"
  251. Philippe Batailler, Janvier 2001.
  252. .rn }` ''
  253. .IX Title "DPKG-SCANSOURCES 1"
  254. .IX Name "dpkg-scansources - prog"
  255. .IX Header "NAME"
  256. .IX Header "SYNOPSIS"
  257. .IX Header "DESCRIPTION"
  258. .IX Header "OPTIONS"
  259. .IX Item "\fB--debug\fR"
  260. .IX Item "\fB--help\fR"
  261. .IX Item "\fB\-n\fR, \fB--no-sort\fR"
  262. .IX Item "\fB\-s\fR, \fB--source-override\fR \fIfile\fR"
  263. .IX Item "\fB--version\fR"
  264. .IX Header "SEE ALSO"
  265. .IX Header "AUTHOR"