Re: autoload and auto-compression-mode

[Eli Zaretskii]

> Date: Fri, 24 Feb 2006 21:58:53 -0600 (CST)
> From: Luc Teirlinck <address@hidden>
> CC: address@hidden, address@hidden
> 
> Anyway, I plan to use the following expanded docstrings of
> `load-suffixes' and `load-file-rep-suffixes'.  (As I already
> mentioned, once the Elisp manual is properly updated, one could put in
> links to the Elisp manual, which can discuss all of this in the proper
> context.)
> 
>   DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
>          doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
> This list should not include the empty string.
> `load' and related functions try to append these suffixes, in order,
> to the specified file name if a Lisp suffix is allowed or required.  */);
>   Vload_suffixes = Fcons (build_string (".elc"),
>                    Fcons (build_string (".el"), Qnil));
>   DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes,
>          doc: /* List of suffixes that indicate representations of \
> the same file.
> This list should normally start with the empty string.
> 
> Enabling Auto Compression mode appends the suffixes in
> `jka-compr-load-suffixes' to this list and disabling Auto Compression
> mode removes them again.  `load' and related functions use this list to
> determine whether they should look for compressed versions of a file
> and, if so, which suffixes they should try to add to the file name
> in order to do so.  However, if you want to customize which suffixes
> the loading functions recognize as compression suffixes, you should
> customize `jka-compr-load-suffixes' rather than the present variable.  */);
>   /* We don't use empty_string because it's not initialized yet.  */
>   Vload_file_rep_suffixes = Fcons (build_string (""), Qnil);

These doc strings are much better, IMO, thanks.