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

Re: proposed changes to debian-faq

Holger Wansing wrote:
> Beatrice Torracca <beatricet@libero.it> wrote:
>> Since Holger is doing such an extensive great job in
>> reorganizing/updating the FAQ I thought this might be a good moment to
>> re-read the FAQs as a "low-level" reviewer. The changes I propose are
>> mostly minor typos and such.
> Great. You found a lot of typos / potential for improvement.
> Some comments on your patch:
>>  <p>Starting with Debian Jessie, some frequently used
>> -<prgn/apt-get/ and <prgn/apt-cache/ commands got an equivalent via
>> +<prgn/apt-get/ and <prgn/apt-cache/ commands have an equivalent via
> 	I don't see the improvement here, so omitting this.

It's a non-native-speakerism.  The current FAQ says that the commands
"got" (="did acquire") an equivalent.   What it's trying to say is
that the commands "have" (="do possess") an equivalent.

>> @@ -321,8 +321,8 @@
>>  status symbol (explained in the header), the package name, the version
>>  which is <em>installed</em>, and a brief description.
>> -<p>To learn the status of packages whose names match the string any
>> -pattern beginning with "foo" by executing the command:
>> +<p>To learn the status of packages whose names match any
>> +pattern beginning with "foo", run the command:
> 	Maybe we should change "learn" into something like "query" here?
> 	Justin?

"Query" would work, but "learn" has the advantage of being simpler
than most of the alternatives, which is helpful here.
>> +<!-- info on httpredir mostly from http://httpredir.debian.org/ -->
>> +<p>Or you can use the redirector httpredir.debian.org which aims to
> 	Or you can use the redirector service httpredir.debian.org ?
> 	(add "service" )

(Those both sound okay, and I don't know which is more accurate.)

>> +  solve the problem of choosing a Debian mirror.  It uses the geographic
>> +  location of the user and other information to choose the best mirror
>> +  that can serve the files.  To take advantage of it use a source like
>> +  this one:
>> +
>> +<example>http://httpredir.debian.org/debian stable main contrib non-free</example>
> 	Maybe we should not include "non-free" in such examples?
> 	Users may copy them directly to their sources.list and have non-free
> 	without knowing of the exact details regarding non-free.
> 	There is another code example in this chapter, which also includes
> 	non-free. I would remove it there too.

(I had a similar thought but was too lazy to check other examples.)
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package

Reply to: