Change browse-url advice for older releases

package does not offer browse-url-default-handlers, but if you set
The code used to advise browse-url-default-browser if your browse-url
browse-url-browser-function to something else, like eww-browse-url,
then that advice did not apply. The code now advises the function set
in the browse-url-browser-function variable, meaning that it should
advise the right function.

Also added a small doc string to the lambda used as advice.

Small documentation fixes

Add missing auto-generated files to .gitignore

Remove 'with-eval-after-load' block for 'browse-url'

It is not necessary (tested with 'emacs -Q').

Organize integrations section

Mark different sections with comments.
Move all declarations for byte compilation to 'eval-when-compile'
blocks at the start of the appropriate sections.

Backfill read-answer for Emacs 26.1

Enable adaptive-fill-mode

When filling long list items or quotes, all lines except for the first
one should be indented by two spaces. Adaptive fill mode handles that.

Fix browse-url for not up-to-date Emacs version

On archlinux, even with Emacs 27.2, browse-url package still does not have
browse-url-default-handlers variable.

Another whitespace/indent cleaning

Add targets in Makefile to build compile lisp file and autoloads

Big refactoring of org related functions

Support elpher in mu4e

Add back with-eval-after-load

- It avoid non-mandatory requirements
- Use feature instead of filename for with-eval-after-load, compared to the
  historic implementation

Cleanup 'thing-at-point' integration

Don't use 'with-eval-after-load'.

Cleanup Org integration

Remove uses of 'with-eval-after-load'.
Remove compatibility with old versions of Org (also bump required
Emacs version to 27.1 accordingly).

Cleanup 'browse-url' integration

Rename 'browse-url-elpher' to 'elpher-browse-url-elpher'.
Autoload 'elpher-browse-url-elpher'.

Cleanup various parts of the package

Add more places which need version bumps in RELEASE.
Ensure most warnings and errors reported by the byte compiler,
checkdoc and package-lint are fixed (only cosmetic changes).
Small fixes to the manual.

Double or drop single non-escape regexp backslashes

Add a RELEASE file

What do I need to remember when releasing a new version? Step 1 is to
remember to increase the version number in all the right places.

Add Daniel to contributors, rename makefile

The GNU Make documentation says "We recommend 'Makefile' because it
appears prominently near the beginning of a directory listing, right
near other important files such as 'README'." Thus the renaming.

Add a makefile

Contains three targets - info, package and clean:
- info creates the info manual for the package.
- package creates an installable (via 'M-x package-install-file')
  package archive.
- clean cleans any "build artefacts".
The default (all) target is equivalent to the clean target followed by
the package target.
Add 'config.mk' for build configuration.
Add 'elpher-pkg.el' (could possibly be generated in the future),
required to install as a package.

Merge remote-tracking branch 'etienne/fix-various' into main

Update contributors list on README to reflect header of lisp file

Fix thing-at-point-uri-schemes error

Avoid anoying error message on homepage when using elpher-go-current

Advertize which search engine is used for gemini and directly call search URL

Bump version in defconst elpher-version

Small typos and doc changes

- URL schema → URL scheme
- drop "internal variable containing"
- replace '() with nil as that seems more idiomatic

update url for gemini search engine

GUS is long dead, long live geminispace.info!

Jump to a heading using imenu

explain better the meaning of default-url-type

"URL type" may be misleading (even though it's how emacs calls it)
when it's actually the schema.

Merge remote-tracking branch 'upstream/patch_better_evil_bindings' into main

Merge remote-tracking branch 'upstream/patch_cache-gemini-page-links' into main

Use xterm-color instead of ansi-color, if possible

xterm-color isn't part of Emacs, so require it but if it can't be
found, require ansi-color instead. Then use two aliases that point
either the xterm-color code or to ansi-color code.

Increase version, add copyright info for all

Only add to browse-url-default-handlers if defined

On some systems, browse-url does not define
browse-url-default-handlers.

Merge remote-tracking branch 'upstream/patch_integrate_with_browse_url' into main

Merge remote-tracking branch 'upstream/patch_org-link-support' into main

Merge remote-tracking branch 'upstream/patch_cert_regexp' into main

Merge remote-tracking branch 'upstream/patch_emacs_tty' into main

Merge remote-tracking branch 'upstream/patch_customizable_default_url_type' into main

Merge remote-tracking branch 'upstream/patch_disable-gnutls-verify' into main

Merge remote-tracking branch 'upstream/patch_fix_crash_in_nox' into main

Merge remote-tracking branch 'upstream/patch_add_autoload_token' into main

Merge remote-tracking branch 'upstream/patch_fix_bookmark_save_crash_when_dir_missing' into main

Merge remote-tracking branch 'upstream/patch_gemini_quoted_face' into main

Merge remote-tracking branch 'upstream/patch_cleanup' into main

Support for C-u elpher to have multiple buffers

Integrate with `browse-url`

Enable opening gopher, gemini and finger links in Elpher by using
`browse-url`. As part of this functionality "gemini://" is registered
as a `thing-at-point` URI scheme so gemini links are interpreted as
URLs.

Store and follow elpher links in org-mode

Store an elpher page org link by executing `org-store-link` and follow
an elpher link within an org-mode buffer by executing
`org-open-at-point`.

Supports gopher, gemini and finger links.

Fix .key regexp for listing existing certs

Fix "wrong type argument" messages when fetching from Gemini.

This is a problem that has affected people using elpher under emacs
in a tty.  I tracked down the cause.  The header filling calculations
fail because the tty font doesn't have a :size property.

There's another proposed fix in patch_header_text_termina, but I
couldn't get that one to work.

make default protocol customizable

This adds a defcustom to let user choose what default URL type elpher
should assume when no one is explicitly given, instead of hardcoding
gopher as it is now.

It also improves a bit how scheme-less URL are handled: `M-x elpher-go
example.com/foo/bar' is now parsed into host `example.com' and path
`/foo/bar'.

Disable gnutls error verification

Gemini sites timeout if the user has gnutls-verify-error set.

Remove another forgotten and useless local variable

It also avoid a crash when displaying page in Emacs without X support

Avoid a crash when displaying page in Emacs without X support

Add autoload token to ‘elpher-go’ and ‘elpher-bookmarks’ functions

Avoid a crash when saving a new bookmark and elpher-bookarks-file dir is missing

As the ‘elpher-bookmarks-file’ is customizable, one can set it to a
non-existent dir (like ‘~/.emacs.d/etc/elpher/bookrmarks’). This commit just
check that the directory part of ‘elpher-bookrmarks-file’ exists before trying
to save it.

Add a new face to customize quoted texts in gemini pages

Remove an unused local variable

Remove some trailing whitespaces

Provide an option to visit clearnet sites over Tor

Simply reuse the mechanism to access onion services, with all of its
disadvantages (e.g., connections are opened synchronously).

Access onion services by a SOCKS proxy (e.g., Tor)

To test this, start the Tor daemon (tor), set the variable socks-server
to the list ("Tor" "localhost" 9050 5), and visit some onion service.

The socks library of Emacs provides a (very limited) alternative to the
regular open-network-stream function. Some of those limitations can be
mitigated by setting the respective options (e.g., the coding system)
later on, instead of when creating the network process object. This is
now done for both indirect and direct connections, for consistency.

TLS is a special case, as the initial connection to the SOCKS server is
typically unencrypted: TLS negotiation only takes place after the proxy
established a connection to the target. The force-ipv4 option is also
a special case, as it is ignored (it obviously cannot work with Tor).

The most serious limitation of the socks library is that opening the
network stream happens synchronously. For this reason, create the timer
before calling socks-open-network-stream. The sentinel function is also
not called automatically in the case of a synchronous open, so call it
explicitly. The appearance of a hanging Emacs is not ideal (even though
users should always be able to abort connection attempts with C-g), but
any improvement probably requires changes in the socks library.

Fixed reported version number. (Sigh.)

Version bump.

Merged Alex Schroeder's header-filling patch.  Thanks!!

Version bump.

Merged Michel Salim's patch.  Thanks!

Cache links in gemini pages.

This patch is based on the patch_add-link-numbering branch. By caching
gemini page links, visiting numbered links now works when one returns
to a previously-visited page (e.g. via `u`).

Add ability to number links on gemini pages.

This patch adds a defcustom, elpher-gemini-number-links, which can be
set to t to display numbers next to links, à la e.g. AV-98. Links can
then be visited by pressing `v` and entering the link number.

Add the missing '^' binding

Better evil bindings.

Applying evil collection guidelines:

- rebinding elpher-go to o, elpher-go-current to O frees the prefix g to
bring gg back
- rebind elpher-jump to J since m is used to mark
- '^' and '-' are bound to elpher-back which is modelled after dired

Visit https://github.com/emacs-evil/evil-collection for more
information.

Ensure certificate directory exists

Before choosing a permanent client certificate, Elpher tries to list
existing certificates. This fails if `elpher-certificate-directory` does
not exist, e.g.

```
---- ERROR -----

When attempting to retrieve gemini://alexschroeder.ch/do/comment/2020-08-14_How_to_comment_using_Elpher:
Opening directory: No such file or directory, /home/michel/.emacs.d/elpher-certificates

----------------

Press 'u' to return to the previous page.
```

Fix by creating the directory unless it exists in
`elpher-list-existing-certificates`.

Signed-off-by: Michel Alexandre Salim <michel@michel-slm.name>

Fill headers

Filling headers is tricky because fill-column is measured in
characters but the font-size for headers is much larger than for
regular text. This change tries to accomodate this by taking the face
for the heading, getting it's font – a string like
"-BE5N-Iosevka-normal-normal-normal-*-29-*-*-*-d-0-iso10646-1" – turns
it into a spec and gets the size from there: 29. We can't use
something like (face-attribute face :height) directly because it might
return a font size in 1/10 point (if an interger) or as a scaling
factor (if a float). Thus, in order to avoid tracking down the face
inheritance tree, we're looking at the font name (a string), in either
XLFD, Fontconfig, or GTK+ format.

Improved default gemini face.

Use "persistent", fixed spelling, updated docs.

Can now install externally-generated certs from within elpher.

Added instructions on how to abort connections.

Removed default ports from urls.

Fixed spelling error. *facepalm*

Added enhancement requests.

Added entry for "F"orget command to start page.

Tidying up for next release.

Added client cert documentation to manual.

Closed gemini support issue. :-)

Improved client cert UX.

Added basic client cert functionality.

Version bump.

Linting following refactor.

Refactored data transfer code.

This is a significant change.
The network code which was previously spread out among
elpher-get-selector, elpher-get-gemini-response and
elpher-get-finger-page has been replaced by a single
elpher-get-host-reponse function.

In addition, we now use make-network-process instead of
open-network-stream, as this affords us greater flexibility
in speicyfing connections.  This allows us to properly
specify ipv4, when necessary.

Connection error reporting has been improved, and connection
state is now explicitly reported.

Encode URLs before display in mouse-over.

Wasn't doing this previously as it's faster not to (and
it's only the help text and can't be otherwise used),
but rendering special characters in the mouse-over text
apparently causes Emacs to crash on MacOS! >:(

Version bump.

Revert port-stripping from elpher-address-to-url.

This seemed to be randomly adding the :0 port specifier
to URLs, breaking links.  The stripping should be
implemented, but this requires more thought.

Version bump.

elpher-go now trims surrounding whitespace from input string.

Strip default port numbers from URL strings.

Tiny refactor.

Grab port as well as host from elpher-current-page

Added confirmation for bookmark deletion.

Slight refactor following merge, linting.