doc/filters: mention input requirements for ebur128

[ffmpeg] / doc / mailing-list-faq.texi

diff --git a/doc/mailing-list-faq.texi b/doc/mailing-list-faq.texi
index 9af89815d5254ee9bcd3dff4599cdcc2e3ad2e19..132c03755469c91d55966686cccd7a741d5b516b 100644 (file)
--- a/doc/mailing-list-faq.texi
+++ b/doc/mailing-list-faq.texi
@@ -47,7 +47,8 @@ We cannot provide help for scripts and/or third-party tools.
 @anchor{How do I ask a question or send a message to a mailing list?}
 @section How do I ask a question or send a message to a mailing list?
 
 @anchor{How do I ask a question or send a message to a mailing list?}
 @section How do I ask a question or send a message to a mailing list?
 

-All you have to do is send an email:
+First you must @ref{How do I subscribe?, subscribe}. Then all you have to do is
+send an email:

 
 @itemize
 @item
 
 @itemize
 @item


@@ -57,48 +58,13 @@ ffmpeg-user mailing list.
 @item
 Email @email{libav-user@@ffmpeg.org} to send a message to the
 libav-user mailing list.
 @item
 Email @email{libav-user@@ffmpeg.org} to send a message to the
 libav-user mailing list.

-@end itemize
-
-If you are not subscribed to the mailing list then your question must be
-manually approved. Approval may take several days, but the wait is
-usually less. If you want the message to be sent with no delay then you
-must subscribe first. See @ref{How do I subscribe?}
-
-Please do not send a message, subscribe, and re-send the message: this
-results in duplicates, causes more work for the admins, and may lower
-your chance at getting an answer. However, you may do so if you first
-@ref{How do I delete my message in the moderation queue?, delete your original message from the moderation queue}.
-
-@chapter Subscribing / Unsubscribing
-
-@section What does subscribing do?

 
 

-Subscribing allows two things:
-
-@itemize

 @item
 @item

-Your messages will show up in the mailing list without waiting in the
-moderation queue and needing to be manually approved by a mailing list
-admin.
-
-@item
-You will receive all messages to the mailing list including replies to
-your messages. Non-subscribed users do not receive any messages.
+Email @email{ffmpeg-devel@@ffmpeg.org} to send a message to the
+ffmpeg-devel mailing list.

 @end itemize
 
 @end itemize
 

-@section Do I need to subscribe?
-
-No. You can still send a message to the mailing list without
-subscribing. See @ref{How do I ask a question or send a message to a mailing list?}
-
-However, your message will need to be manually approved by a mailing
-list admin, and you will not receive any mailing list messages or
-replies.
-
-You can ask to be CCd in your message, but replying users will
-sometimes forget to do so.
-
-You may also view and reply to messages via the @ref{Where are the archives?, archives}.
+@chapter Subscribing / Unsubscribing

 
 @anchor{How do I subscribe?}
 @section How do I subscribe?
 
 @anchor{How do I subscribe?}
 @section How do I subscribe?


@@ -124,6 +90,9 @@ The process is the same for the other mailing lists.
 Please avoid asking a mailing list admin to unsubscribe you unless you
 are absolutely unable to do so by yourself. See @ref{Who do I contact if I have a problem with the mailing list?}
 
 Please avoid asking a mailing list admin to unsubscribe you unless you
 are absolutely unable to do so by yourself. See @ref{Who do I contact if I have a problem with the mailing list?}
 

+Note that it is possible to temporarily halt message delivery (vacation mode).
+See @ref{How do I disable mail delivery without unsubscribing?}
+

 @chapter Moderation Queue
 @anchor{Why is my message awaiting moderator approval?}
 @section Why is my message awaiting moderator approval?
 @chapter Moderation Queue
 @anchor{Why is my message awaiting moderator approval?}
 @section Why is my message awaiting moderator approval?


@@ -134,8 +103,6 @@ must be manually approved by a mailing list admin:
 These are:
 
 @itemize
 These are:
 
 @itemize

-@item
-Messages from users who are @strong{not} subscribed.

 
 @item
 Messages that exceed the @ref{What is the message size limit?, message size limit}.
 
 @item
 Messages that exceed the @ref{What is the message size limit?, message size limit}.


@@ -148,13 +115,13 @@ or is abusive towards others).
 
 @section How long does it take for my message in the moderation queue to be approved?
 
 
 @section How long does it take for my message in the moderation queue to be approved?
 

-The queue is usually checked once or twice a day, but on occasion
-several days may pass before someone checks the queue.
+The queue is not checked on a regular basis. You can ask on the
+@t{#ffmpeg-devel} IRC channel on Freenode for someone to approve your message.

 
 @anchor{How do I delete my message in the moderation queue?}
 @section How do I delete my message in the moderation queue?
 
 
 @anchor{How do I delete my message in the moderation queue?}
 @section How do I delete my message in the moderation queue?
 

-You should have received an email with the subject @emph{Your message to ffmpeg-user awaits moderator approval}.
+You should have received an email with the subject @emph{Your message to <mailing list name> awaits moderator approval}.

 A link is in the message that will allow you to delete your message
 unless a mailing list admin already approved or rejected it.
 
 A link is in the message that will allow you to delete your message
 unless a mailing list admin already approved or rejected it.
 


@@ -175,6 +142,9 @@ Click the email link at the top of the message just under the subject
 title. The link will provide the proper headers to keep the message
 within the thread.
 
 title. The link will provide the proper headers to keep the message
 within the thread.
 

+Note that you must be subscribed to send a message to the ffmpeg-user or
+libav-user mailing lists.
+

 @section How do I search the archives?
 
 Perform a site search using your favorite search engine. Example:
 @section How do I search the archives?
 
 Perform a site search using your favorite search engine. Example:


@@ -187,11 +157,12 @@ Perform a site search using your favorite search engine. Example:
 
 You can ask for help in the official @t{#ffmpeg} IRC channel on Freenode.
 
 
 You can ask for help in the official @t{#ffmpeg} IRC channel on Freenode.
 

-Some users prefer the third-party Nabble interface which presents the
-mailing lists in a typical forum layout.
+Some users prefer the third-party @url{http://www.ffmpeg-archive.org/, Nabble}
+interface which presents the mailing lists in a typical forum layout.

 
 

-There are also numerous third-party help sites such as Super User and
-r/ffmpeg on reddit.
+There are also numerous third-party help sites such as
+@url{https://superuser.com/tags/ffmpeg, Super User} and
+@url{https://www.reddit.com/r/ffmpeg/, r/ffmpeg on reddit}.

 
 @anchor{What is top-posting?}
 @section What is top-posting?
 
 @anchor{What is top-posting?}
 @section What is top-posting?


@@ -203,16 +174,15 @@ Instead, use trimmed interleaved/inline replies (@url{https://lists.ffmpeg.org/p
 @anchor{What is the message size limit?}
 @section What is the message size limit?
 
 @anchor{What is the message size limit?}
 @section What is the message size limit?
 

-The message size limit is 500 kilobytes for the user lists and 1000
-kilobytes for ffmpeg-devel. Please provide links to larger files instead
-of attaching them.
+The message size limit is 1000 kilobytes. Please provide links to larger files
+instead of attaching them.

 
 @section Where can I upload sample files?
 
 Anywhere that is not too annoying for us to use.
 
 Google Drive and Dropbox are acceptable if you need a file host, and
 
 @section Where can I upload sample files?
 
 Anywhere that is not too annoying for us to use.
 
 Google Drive and Dropbox are acceptable if you need a file host, and

-0x0.st is good for files under 256 MiB.
+@url{https://0x0.st/, 0x0.st} is good for files under 256 MiB.

 
 Small, short samples are preferred if possible.
 
 
 Small, short samples are preferred if possible.
 


@@ -259,6 +229,34 @@ or headers.
 
 You can then filter the mailing list messages to their own folder.
 
 
 You can then filter the mailing list messages to their own folder.
 

+@anchor{How do I disable mail delivery without unsubscribing?}
+@section How do I disable mail delivery without unsubscribing?
+
+Sometimes you may want to temporarily stop receiving all mailing list
+messages. This "vacation mode" is simple to do:
+
+@enumerate
+@item
+Go to the @url{https://lists.ffmpeg.org/mailman/listinfo/ffmpeg-user/, ffmpeg-user mailing list info page}
+
+@item
+Enter your email address in the box at very bottom of the page and click the
+@emph{Unsubscribe or edit options} box.
+
+@item
+Enter your password and click the @emph{Log in} button.
+
+@item
+Look for the @emph{Mail delivery} option. Here you can disable/enable mail
+delivery. If you check @emph{Set globally} it will apply your choice to all
+other FFmpeg mailing lists you are subscribed to.
+@end enumerate
+
+Alternatively, from your subscribed address, send a message to @email{ffmpeg-user-request@@ffmpeg.org}
+with the subject @emph{set delivery off}. To re-enable mail delivery send a
+message to @email{ffmpeg-user-request@@ffmpeg.org} with the subject
+@emph{set delivery on}.
+

 @chapter Rules and Etiquette
 
 @section What are the rules and the proper etiquette?
 @chapter Rules and Etiquette
 
 @section What are the rules and the proper etiquette?