cleanup-info.8 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. .TH cleanup\-info 8 "2006-02-28" "Debian Project" "dpkg utilities"
  2. .SH NAME
  3. cleanup\-info \- clean up the mess that bogus install\-info may have done
  4. .
  5. .SH SYNOPSIS
  6. .B cleanup\-info
  7. [\fB\-\-help\fP] [\fB\-\-unsafe\fP] [\fB\-\-version\fP] [\fB\-\-\fP]
  8. [\fI<dirname>\fP]
  9. .
  10. .SH DESCRIPTION
  11. .B cleanup\-info
  12. is a Perl script that tries to clean up the mess that bogus
  13. .BR install\-info (8)
  14. may have done.
  15. It gathers all sections with the same heading into a single one.
  16. It tries to be smart about cases and trailing colon/spaces.
  17. .br
  18. Other clean-ups include removing of empty sections, and squeezing the blank
  19. lines (in entries part only).
  20. .sp
  21. Order of sections is preserved (the first encountered section counts).
  22. Order of entries within a section is preserved.
  23. .sp
  24. Please be \fBextremely careful\fP when using this utility - it might
  25. not be 100% safe. cleanup\-info tries to be careful with your info dir
  26. file, but only until it writes it. You should back the file up prior
  27. to using this script.
  28. .
  29. .SH OPTIONS
  30. .TP
  31. .B \-\-help
  32. Output the help screen and exit successfully.
  33. .TP
  34. .B \-\-unsafe
  35. Set some additional possibly useful options.
  36. .br
  37. .B "Warning: the `\-\-unsafe' option may garble an otherwise correct file!"
  38. .TP
  39. .B \-\-version
  40. Output version and exit successfully.
  41. .
  42. .SH FILES
  43. .TP
  44. .IR /usr/info/dir " or " <dirname>/dir
  45. The info directory file. The lock file is named the same, with ".lock" suffix.
  46. .
  47. .SH BUGS
  48. Probably many.
  49. .
  50. .SH SEE ALSO
  51. .BR install\-info (8),
  52. .BR info (1).
  53. .SH AUTHOR
  54. Copyright (C) 1996 Kim-Minh Kaplan.
  55. .sp
  56. This is free software; see the GNU General Public Licence
  57. version 2 or later for copying conditions. There is NO warranty.