Public bug reported:
Using davfs2 1.7.2-1 on resolute amd64
The source manpage contains placeholders that some build mechanism shall
replace with
real values. This is not the case. the mount.davfs.8 man page is full of
placeholders
@PROGRAM_NAME@, @PACKAGE@, @PACKAGE@/@SECRETSFILE@ SYS_CONF_DIR@/@CONFIGFILE@
and so
on. I can guess what @PROGRAM_NAME@ is but I remain clueless at what the
configuration
files could be.
What I expect in the manual is that the placeholders are replaced with real
values
that are used on the distribution I use, so that it provides useful
informations.
Here are some excerpts of what I get when I run "man mount.davfs":
> @PROGRAM_NAME@(8) System Manager's Manual @PROGRAM_NAME@(8)
>
> NAME
> @PROGRAM_NAME@ - Mount a WebDAV resource as @PACKAGE@ file
> system
>
> SYNOPSIS
> @PROGRAM_NAME@ [-h | --help] [-V | --version]
> mount {dir | webdavserver}
>
> SYNOPSIS (root only)
> mount -t davfs [-o option[,...]] webdavserver dir
> @PROGRAM_NAME@ [-o option[,...]] webdavserver dir
>
> DESCRIPTION
> @PROGRAM_NAME@ allows you to mount the WebDAV resource identi‐
> fied by webdavserver into the local filesystem at dir. WebDAV
> is an extension to HTTP that allows remote, collaborative au‐
> thoring of Web resources, defined in RFC 4918. @PROGRAM_NAME@
> is part of @PACKAGE@.
...
> If a proxy must be used this should be configured in
> @SYS_CONF_DIR@/@CONFIGFILE@
> proxy proxy.mycompany.com:8080
>
> Credentials are stored in /home/filomena/.@PACKAGE@/@SECRETS‐
> FILE@
> proxy.mycompany.com filomena "my secret"
> /media/dav webdav-username password
** Affects: davfs2 (Ubuntu)
Importance: Undecided
Status: New
** Tags: documentation
--
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/2159003
Title:
@placeholders@ not replaced in manpage
To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/davfs2/+bug/2159003/+subscriptions
--
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs
