[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#65386: [PATCH] ; Refine some 'package-vc' docstrings
From: |
Eshel Yaron |
Subject: |
bug#65386: [PATCH] ; Refine some 'package-vc' docstrings |
Date: |
Sun, 20 Aug 2023 09:15:08 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) |
Hi,
>> > What is the significance of "from source" here?
>>
>> It's just for indicating that we're talking about VC packages
>> specifically. Does that make sense?
>
> Then how about
>
> List of packages to install from their VCS repositories.
>
SGTM, updated in the new patch (v3) I've attached below.
>> >> + "Send patch for REVISIONS to maintainer of the package PKG-DESC using
>> >> SUBJECT.
>> >
>> > This should mention email, otherwise SUBJECT is confusing. Maybe use
>> > "Email" instead of "Send".
>>
>> Alright, I made a couple more changes to this one.
>
> Now you have lost the reference to SUBJECT. Was that necessary? We
> generally try to mention all the mandatory arguments in the first line
> of the doc string. The sentence below seems to be squeezable into 79
> columns:
>
> Email patches for REVISIONS to maintainer of package PKG-DESC using SUBJECT.
>
> (Dropping articles is a frequent trick to make the first line fit.)
Nicely squeezed :) I've adopted your phrasing in the patch below.
v3-0001-Refine-some-package-vc-docstrings.patch
Description: Text Data
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/19
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eli Zaretskii, 2023/08/19
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/19
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eli Zaretskii, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings,
Eshel Yaron <=
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Philip Kaludercic, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Philip Kaludercic, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Philip Kaludercic, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Philip Kaludercic, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Eshel Yaron, 2023/08/20
- bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Philip Kaludercic, 2023/08/20
bug#65386: [PATCH] ; Refine some 'package-vc' docstrings, Mauro Aranda, 2023/08/20