cleanup-info.8 1.5 KB

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