Mercurial > hgrepos > Python2 > PyMuPDF

comparison mupdf-source/thirdparty/curl/docs/MAIL-ETIQUETTE @ 2:b50eed0cc0ef upstream

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 _ _ ____ _
2 ___| | | | _ \| |
3 / __| | | | |_) | |
4 | (__| |_| | _ <| |___
5 \___|\___/|_| \_\_____|
6
7 MAIL ETIQUETTE
8
9 1. About the lists
10 1.1 Mailing Lists
11 1.2 Netiquette
12 1.3 Do Not Mail a Single Individual
13 1.4 Subscription Required
14 1.5 Moderation of new posters
15 1.6 Handling trolls and spam
16 1.7 How to unsubscribe
17 1.8 I posted, now what?
18 1.9 Your emails are public
19
20 2. Sending mail
21 2.1 Reply or New Mail
22 2.2 Reply to the List
23 2.3 Use a Sensible Subject
24 2.4 Do Not Top-Post
25 2.5 HTML is not for mails
26 2.6 Quoting
27 2.7 Digest
28 2.8 Please Tell Us How You Solved The Problem!
29
30 ==============================================================================
31
32 1. About the lists
33
34 1.1 Mailing Lists
35
36 The mailing lists we have are all listed and described at
37 https://curl.haxx.se/mail/
38
39 Each mailing list is targeted to a specific set of users and subjects,
40 please use the one or the ones that suit you the most.
41
42 Each mailing list has hundreds up to thousands of readers, meaning that
43 each mail sent will be received and read by a very large number of people.
44 People from various cultures, regions, religions and continents.
45
46 1.2 Netiquette
47
48 Netiquette is a common term for how to behave on the internet. Of course, in
49 each particular group and subculture there will be differences in what is
50 acceptable and what is considered good manners.
51
52 This document outlines what we in the curl project consider to be good
53 etiquette, and primarily this focus on how to behave on and how to use our
54 mailing lists.
55
56 1.3 Do Not Mail a Single Individual
57
58 Many people send one question to one person. One person gets many mails, and
59 there is only one person who can give you a reply. The question may be
60 something that other people would also like to ask. These other people have
61 no way to read the reply, but to ask the one person the question. The one
62 person consequently gets overloaded with mail.
63
64 If you really want to contact an individual and perhaps pay for his or her
65 services, by all means go ahead, but if it's just another curl question,
66 take it to a suitable list instead.
67
68 1.4 Subscription Required
69
70 All curl mailing lists require that you are subscribed to allow a mail to go
71 through to all the subscribers.
72
73 If you post without being subscribed (or from a different mail address than
74 the one you are subscribed with), your mail will simply be silently
75 discarded. You have to subscribe first, then post.
76
77 The reason for this unfortunate and strict subscription policy is of course
78 to stop spam from pestering the lists.
79
80 1.5 Moderation of new posters
81
82 Several of the curl mailing lists automatically make all posts from new
83 subscribers be moderated. This means that after you've subscribed and
84 sent your first mail to a list, that mail will not be let through to the
85 list until a mailing list administrator has verified that it is OK and
86 permits it to get posted.
87
88 Once a first post has been made that proves the sender is actually talking
89 about curl-related subjects, the moderation "flag" will be switched off and
90 future posts will go through without being moderated.
91
92 The reason for this moderation policy is that we do suffer from spammers who
93 actually subscribe and send spam to our lists.
94
95 1.6 Handling trolls and spam
96
97 Despite our good intentions and hard work to keep spam off the lists and to
98 maintain a friendly and positive atmosphere, there will be times when spam
99 and or trolls get through.
100
101 Troll - "someone who posts inflammatory, extraneous, or off-topic messages
102 in an online community"
103
104 Spam - "use of electronic messaging systems to send unsolicited bulk
105 messages"
106
107 No matter what, we NEVER EVER respond to trolls or spammers on the list. If
108 you believe the list admin should do something in particular, contact him/her
109 off-list. The subject will be taken care of as much as possible to prevent
110 repeated offenses, but responding on the list to such messages never leads to
111 anything good and only puts the light even more on the offender: which was
112 the entire purpose of it getting sent to the list in the first place.
113
114 Don't feed the trolls!
115
116 1.7 How to unsubscribe
117
118 You can unsubscribe the same way you subscribed in the first place. You go
119 to the page for the particular mailing list you're subscribed to and you enter
120 your email address and password and press the unsubscribe button.
121
122 Also, the instructions to unsubscribe are included in the headers of every
123 mail that is sent out to all curl related mailing lists and there's a footer
124 in each mail that links to the "admin" page on which you can unsubscribe and
125 change other options.
126
127 You NEVER EVER email the mailing list requesting someone else to take you off
128 the list.
129
130 1.8 I posted, now what?
131
132 If you aren't subscribed with the exact same email address that you used to
133 send the email, your post will just be silently discarded.
134
135 If you posted for the first time to the mailing list, you first need to wait
136 for an administrator to allow your email to go through (moderated). This normally
137 happens very quickly but in case we're asleep, you may have to wait a few
138 hours.
139
140 Once your email goes through it is sent out to several hundred or even
141 thousands of recipients. Your email may cover an area that not that many people
142 know about or are interested in. Or possibly the person who knows about it
143 is on vacation or under a very heavy work load right now. You may have to wait
144 for a response and you should not expect to get a response at all, but
145 hopefully you get an answer within a couple of days.
146
147 You do yourself and all of us a service when you include as many details as
148 possible already in your first email. Mention your operating system and
149 environment. Tell us which curl version you're using and tell us what you
150 did, what happened and what you expected would happen. Preferably, show us
151 what you did with details enough to allow others to help point out the problem
152 or repeat the same steps in their locations.
153
154 Failing to include details will only delay responses and make people respond
155 and ask for more details and you will have to send a follow-up email that
156 includes them.
157
158 Expect the responses to primarily help YOU debug the issue, or ask YOU
159 questions that can lead you or others towards a solution or explanation to
160 whatever you experience.
161
162 If you are a repeat offender to the guidelines outlined in this document,
163 chances are that people will ignore you at will and your chances to get
164 responses in the future will greatly diminish.
165
166 1.9 Your emails are public
167
168 Your email, its contents and all its headers and the details in those
169 headers will be received by every subscriber of the mailing list that you
170 send your email to.
171
172 Your email as sent to a curl mailing list will end up in mail archives, on
173 the curl web site and elsewhere, for others to see and read. Today and in
174 the future. In addition to the archives, the mail is sent out to thousands
175 of individuals. There is no way to undo a sent email.
176
177 When sending emails to a curl mailing list, do not include sensitive
178 information such as user names and passwords; use fake ones, temporary ones
179 or just remove them completely from the mail. Note that this includes base64
180 encoded HTTP Basic auth headers.
181
182 This public nature of the curl mailing lists makes automatically inserted mail
183 footers about mails being "private" or "only meant for the recipient" or
184 similar even more silly than usual. Because they are absolutely not private
185 when sent to a public mailing list.
186
187
188 2. Sending mail
189
190 2.1 Reply or New Mail
191
192 Please do not reply to an existing message as a short-cut to post a message
193 to the lists.
194
195 Many mail programs and web archivers use information within mails to keep
196 them together as "threads", as collections of posts that discuss a certain
197 subject. If you don't intend to reply on the same or similar subject, don't
198 just hit reply on an existing mail and change subject, create a new mail.
199
200 2.2 Reply to the List
201
202 When replying to a message from the list, make sure that you do "group
203 reply" or "reply to all", and not just reply to the author of the single
204 mail you reply to.
205
206 We're actively discouraging replying back to the single person by setting
207 the Reply-To: field in outgoing mails back to the mailing list address,
208 making it harder for people to mail the author directly, if only by mistake.
209
210 2.3 Use a Sensible Subject
211
212 Please use a subject of the mail that makes sense and that is related to the
213 contents of your mail. It makes it a lot easier to find your mail afterwards
214 and it makes it easier to track mail threads and topics.
215
216 2.4 Do Not Top-Post
217
218 If you reply to a message, don't use top-posting. Top-posting is when you
219 write the new text at the top of a mail and you insert the previous quoted
220 mail conversation below. It forces users to read the mail in a backwards
221 order to properly understand it.
222
223 This is why top posting is so bad (in top posting order):
224
225 A: Because it messes up the order in which people normally read text.
226 Q: Why is top-posting such a bad thing?
227 A: Top-posting.
228 Q: What is the most annoying thing in e-mail?
229
230 Apart from the screwed up read order (especially when mixed together in a
231 thread when someone responds using the mandated bottom-posting style), it
232 also makes it impossible to quote only parts of the original mail.
233
234 When you reply to a mail. You let the mail client insert the previous mail
235 quoted. Then you put the cursor on the first line of the mail and you move
236 down through the mail, deleting all parts of the quotes that don't add
237 context for your comments. When you want to add a comment you do so, inline,
238 right after the quotes that relate to your comment. Then you continue
239 downwards again.
240
241 When most of the quotes have been removed and you've added your own words,
242 you're done!
243
244 2.5 HTML is not for mails
245
246 Please switch off those HTML encoded messages. You can mail all those funny
247 mails to your friends. We speak plain text mails.
248
249 2.6 Quoting
250
251 Quote as little as possible. Just enough to provide the context you cannot
252 leave out. A lengthy description can be found here:
253
254 https://www.netmeister.org/news/learn2quote.html
255
256 2.7 Digest
257
258 We allow subscribers to subscribe to the "digest" version of the mailing
259 lists. A digest is a collection of mails lumped together in one single mail.
260
261 Should you decide to reply to a mail sent out as a digest, there are two
262 things you MUST consider if you really really cannot subscribe normally
263 instead:
264
265 Cut off all mails and chatter that is not related to the mail you want to
266 reply to.
267
268 Change the subject name to something sensible and related to the subject,
269 preferably even the actual subject of the single mail you wanted to reply to
270
271 2.8 Please Tell Us How You Solved The Problem!
272
273 Many people mail questions to the list, people spend some of their time and
274 make an effort in providing good answers to these questions.
275
276 If you are the one who asks, please consider responding once more in case
277 one of the hints was what solved your problems. The guys who write answers
278 feel good to know that they provided a good answer and that you fixed the
279 problem. Far too often, the person who asked the question is never heard from
280 again, and we never get to know if he/she is gone because the problem was
281 solved or perhaps because the problem was unsolvable!
282
283 Getting the solution posted also helps other users that experience the same
284 problem(s). They get to see (possibly in the web archives) that the
285 suggested fixes actually has helped at least one person.