904-doc-manpages.patch 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. Author: Michael Piefel <piefel@debian.org>
  2. Description: FIXME, and #417511.
  3. diff -Naurp file.orig/doc/file.man file/doc/file.man
  4. --- file.orig/doc/file.man 2008-11-06 23:18:35.000000000 +0000
  5. +++ file/doc/file.man 2009-02-18 12:28:42.000000000 +0000
  6. @@ -51,7 +51,7 @@ meaning anything else (data is usually
  7. or non-printable).
  8. Exceptions are well-known file formats (core files, tar archives)
  9. that are known to contain binary data.
  10. -When modifying magic files or the program itself, make sure to
  11. +When adding local definitions to /etc/magic, make sure to
  12. .Em "preserve these keywords" .
  13. Users depend on knowing that all the readable files in a directory
  14. have the word
  15. @@ -95,7 +95,8 @@ The concept of a
  16. has been applied by extension to data files.
  17. Any file with some invariant identifier at a small fixed
  18. offset into the file can usually be described in this way.
  19. -The information identifying these files is read from the compiled
  20. +The information identifying these files is read from /etc/magic
  21. +and the the compiled
  22. magic file
  23. .Pa __MAGIC__.mgc ,
  24. or the files in the directory
  25. @@ -325,6 +326,11 @@ will not attempt to open
  26. adds
  27. .Sq .mgc
  28. to the value of this variable as appropriate.
  29. +However,
  30. +.Pa file
  31. +has to exist in order for
  32. +.Pa file.mime
  33. +to be considered.
  34. The environment variable
  35. .Dv POSIXLY_CORRECT
  36. controls (on systems that support symbolic links), whether
  37. @@ -400,12 +406,6 @@ will be distributed periodically.
  38. The order of entries in the magic file is significant.
  39. Depending on what system you are using, the order that
  40. they are put together may be incorrect.
  41. -If your old
  42. -.Nm
  43. -command uses a magic file,
  44. -keep the old magic file around for comparison purposes
  45. -(rename it to
  46. -.Pa __MAGIC__.orig ).
  47. .Sh EXAMPLES
  48. .Bd -literal -offset indent
  49. $ file file.c file /dev/{wd0a,hda}
  50. @@ -547,3 +547,8 @@ on
  51. .Dv ftp.astron.com
  52. in the directory
  53. .Dv /pub/file/file-X.YZ.tar.gz
  54. +.Pp
  55. +This Debian version adds a number of new magic entries. It can be
  56. +obtained from every site carrying a Debian distribution (that is
  57. +.Dv ftp.debian.org
  58. +and mirrors).