discuss: Filesystem paths in LDP documentation


Previous by date: 13 Apr 2002 22:12:51 -0000 Re: Filesystem paths in LDP documentation, Charles Curley
Next by date: 13 Apr 2002 22:12:51 -0000 Re: [ATTN: lists are moving on April, 15th], Guylhem P Aznar
Previous in thread: 13 Apr 2002 22:12:51 -0000 Re: Filesystem paths in LDP documentation, Charles Curley
Next in thread: 13 Apr 2002 22:12:51 -0000 Re: Filesystem paths in LDP documentation, Mark Komarinski

Subject: Re: Filesystem paths in LDP documentation
From: David Merrill ####@####.####
Date: 13 Apr 2002 22:12:51 -0000
Message-Id: <20020413230434.GB17606@lupercalia.net>

On Sat, Apr 13, 2002 at 03:40:31PM -0600, Charles Curley wrote:
> On Sat, Apr 13, 2002 at 03:41:30PM -0500, David Merrill wrote:
> > On Sat, Apr 13, 2002 at 03:58:45PM +0100, Colin Watson wrote:
> > > Hi,
> 
> 
> > > The bug opens a wider issue, though. To what extent do readers of this
> > > list think it's reasonable for distributions to patch their LDP packages
> > > to refer to locally-appropriate paths? On the one hand, it may alleviate
> > > confusion when readers find documents referring to paths that aren't on
> > > their systems. On the other hand, the document probably won't be perfect
> > > for each distribution anyway unless the author planned it that way, I
> > > suspect most authors would rather that distributions didn't make local
> > > changes without passing them back, and I doubt I have time to go around
> > > carefully patching the whole LDP all the time.
> > 
> > It's always better to get the patch accepted upstream if possible. If
> > you have to patch locally, then so be it. The LDP will work with you
> > to get the fix added by the author, or we'll fix it ourselves if the
> > author does not.
> 
> Speaking as an author, I welcome such errata.

Charles, I just cannot express how happy I am for authors like
yourself who stay on top of their documents and who appreciate
feedback. But in all sincerity, you and those like you are not the
problem. The problem is authors who do not update, and documents whose
maintainers completely abandoned them, leaving them unmaintained!

> Perhaps LDP should also ecourage authors do things like, "This file is
> found in the Blah directory. It is this path on Red Hat X.Y, that path
> on Debian m.n, and may be elsewhere on your system." That will make it
> easy to add new paths as readers or distributors send errata. This may
> be a candidate for the Authors Guide.

Hmmm. I can't state this as *fact*, but I believe most or all of the
distributions are using the FHS for these files now. If that is a
fact, then we should say that recent distros place them in /foo (per
FHS), but older distros may not.

-- 
David C. Merrill                         http://www.lupercalia.net
Linux Documentation Project                   ####@####.####
Lead Developer                             http://www.linuxdoc.org

Will I lose my dignity
Will someone care
Will I wake tomorrow
From this nightmare?
	-- RENT

--> -->
 
 
<type 'exceptions.IOError'>
Python 2.5.2: /usr/bin/python
Wed Jul 3 17:35:07 2024

A problem occurred in a Python script. Here is the sequence of function calls leading up to the error, in the order they occurred.

 /opt/ezmlm-browse-0.20/<string> in ()
 /opt/ezmlm-browse-0.20/main.py in main()
  424 
  425         if path is not None:
  426                 main_path(path)
  427         else:
  428                 main_form()
global main_form = <function main_form at 0x9bbdc6c>
 /opt/ezmlm-browse-0.20/main.py in main_form()
  378         except ImportError:
  379                 die(ctxt, "Invalid command")
  380         module.do(ctxt)
  381 
  382 def main():
module = <module 'commands.showmsg' from '/opt/ezmlm-browse-0.20/commands/showmsg.pyc'>, module.do = <function do at 0x9bcfbc4>, global ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}
 /opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'})
   18         write(html('msg-pager') % ctxt)
   19         write('<hr>')
   20         sub_showmsg(ctxt, ctxt[MSGNUM])
   21         write('<hr>')
   22         write(html('msg-pager') % ctxt)
global sub_showmsg = <function sub_showmsg at 0x9bbd1ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum'
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=2785)
  229         format_timestamp(ctxt, ctxt)
  230         write(html('msg-header') % ctxt)
  231         rec_showpart(ctxt, msg, 0)
  232         write(html('msg-footer') % ctxt)
  233         ctxt.pop()
global rec_showpart = <function rec_showpart at 0x9bbd1b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0x9c2df4c>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9c2df4c>, partnum=1)
  205                 else:
  206                         for p in part.get_payload():
  207                                 partnum = rec_showpart(ctxt, p, partnum+1)
  208         else:
  209                 write(html('msg-sep') % ctxt)
partnum = 1, global rec_showpart = <function rec_showpart at 0x9bbd1b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0x9c351cc>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9c351cc>, partnum=2)
  208         else:
  209                 write(html('msg-sep') % ctxt)
  210                 sub_showpart(ctxt, part)
  211         return partnum
  212 
global sub_showpart = <function sub_showpart at 0x9bbd144>, ctxt = {'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0x9c351cc>
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 3, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x9c351cc>)
  164         type = ctxt[TYPE] = part.get_content_type()
  165         ctxt[FILENAME] = part.get_filename()
  166         template = html('msg-' + type.replace('/', '-'))
  167         if not template:
  168                 template = html('msg-' + type[:type.find('/')])
global template = <function template at 0x9bb5e9c>, global html = <function html at 0x9bb5ed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x9c360c8>
 /opt/ezmlm-browse-0.20/globalfns.py in html(name='msg-application-pgp-signature')
   40 
   41 def html(name):
   42         return template(name + '.html')
   43 
   44 def xml(name):
global template = <function template at 0x9bb5e9c>, name = 'msg-application-pgp-signature'
 /opt/ezmlm-browse-0.20/globalfns.py in template(filename='msg-application-pgp-signature.html')
   31         except IOError:
   32                 if not _template_zipfile:
   33                         _template_zipfile = zipfile.ZipFile(sys.argv[0])
   34                 try:
   35                         f = _template_zipfile.open(n).read()
global _template_zipfile = None, global zipfile = <module 'zipfile' from '/usr/lib/python2.5/zipfile.pyc'>, zipfile.ZipFile = <class zipfile.ZipFile at 0x9b4ea7c>, global sys = <module 'sys' (built-in)>, sys.argv = ['-c', '/opt/ezmlm-browse-0.20']
 /usr/lib/python2.5/zipfile.py in __init__(self=<zipfile.ZipFile instance at 0x9bcc46c>, file='-c', mode='r', compression=0, allowZip64=False)
  337             self.filename = file
  338             modeDict = {'r' : 'rb', 'w': 'wb', 'a' : 'r+b'}
  339             self.fp = open(file, modeDict[mode])
  340         else:
  341             self._filePassed = 1
self = <zipfile.ZipFile instance at 0x9bcc46c>, self.fp = None, builtin open = <built-in function open>, file = '-c', modeDict = {'a': 'r+b', 'r': 'rb', 'w': 'wb'}, mode = 'r'

<type 'exceptions.IOError'>: [Errno 2] No such file or directory: '-c'
      args = (2, 'No such file or directory')
      errno = 2
      filename = '-c'
      message = ''
      strerror = 'No such file or directory'