[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: apt-setup bugs / patch review



(dropping CC, please do so as well, as I'm subscribed to the list)

Quoting bofh80 (afm404@gmail.com):
> Ok, here's the other patch too updated with a slightly better template
> thing. Now i noticed the _Description part is different, so i changed it,
> then noticed the other string entries don't have _Description parts.
> 
> I'm now reading http://www.fifi.org/doc/debconf-doc/tutorial.html  and
> https://www.debian.org/doc/packaging-manuals/debconf_specification.html   .
> Any other pages i should be looking at? Since i still can't find info on
> sl2 or _Decription vs Description ....

#sl2 markers give the "sublevel" where the strings will go. Sublevels
are specific to d-i and described in
http://d-i.alioth.debian.org/doc/i18n/ch01s04.html#sublevels

Here, these templates belong to sublevel 3 as they won't probably be
shown in default installs (they should be priority medium or low).


> +Template: apt-setup/local/netrc
> +Type: string
> +_Description: Have a http apt repository that requires authentication?
> + Example: machine packages.server.org login myuser password mypass
> + Does not pull apt/localx/repostory as machine due to possible parse mangle
> + Formats as man netrc suggests

Here, I have to admit that I have absolutely no clue about *what*
should really be in the template (because I don't really understand
what's the purpose of the patch) but the wording definitely needs a
lot of improvement.

First, anyway, "string" templates can't use a question as synopsis. 

You seem to expect users to enter something there, so you should
*prompt* them for this:

_Description: netrc-style entry: 
 Please enter here....blah blah blah (explain what is expected there
 and avoid jargon).
 .
 For instance:
  machine packages.server.org login myuser password mypass

(note the double space meant to guarantee that the last line is
hard(formatted.


Attachment: signature.asc
Description: Digital signature


Reply to: