From edc4614e6339f8e232d1c86d2fe4f15c91ced5b8 Mon Sep 17 00:00:00 2001
From: David Adam <zanchey@ucc.gu.uwa.edu.au>
Date: Mon, 28 Oct 2013 09:57:36 +0800
Subject: [PATCH] add completions for source and document the move away from
 '.'

Closes: #310
---
 Makefile.in                   | 2 +-
 doc_src/source.txt            | 4 ++++
 share/completions/..fish      | 2 +-
 share/completions/source.fish | 1 +
 4 files changed, 7 insertions(+), 2 deletions(-)
 mode change 100644 => 120000 share/completions/..fish
 create mode 100644 share/completions/source.fish

diff --git a/Makefile.in b/Makefile.in
index 2e3a03e30..a0be4973b 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -233,7 +233,7 @@ TESTS_DIR_FILES := $(TEST_IN) $(TEST_IN:.in=.out) $(TEST_IN:.in=.err)	\
 # Files in ./share/completions/
 #
 
-COMPLETIONS_DIR_FILES := $(wildcard share/completions/*.fish)
+COMPLETIONS_DIR_FILES := $(wildcard share/completions/*.fish) share/completions/..fish
 
 
 #
diff --git a/doc_src/source.txt b/doc_src/source.txt
index c49e24912..786577dc4 100644
--- a/doc_src/source.txt
+++ b/doc_src/source.txt
@@ -20,6 +20,10 @@ The return status of \c source is the return status of the last job to
 execute. If something goes wrong while opening or reading the file,
 \c source exits with a non-zero status.
 
+\c . (a single period) is an alias for the \c source command. The use of \c .
+is deprecated in favour of \c source, and \c . will be removed in a future
+version of fish.
+
 \subsection source-example Example
 
 <tt>source ~/.config/fish/config.fish</tt> causes fish to re-read its initialization file.
diff --git a/share/completions/..fish b/share/completions/..fish
deleted file mode 100644
index dcb48a1ed..000000000
--- a/share/completions/..fish
+++ /dev/null
@@ -1 +0,0 @@
-complete -c . -x -a "(__fish_complete_suffix .fish)"
diff --git a/share/completions/..fish b/share/completions/..fish
new file mode 120000
index 000000000..952c26180
--- /dev/null
+++ b/share/completions/..fish
@@ -0,0 +1 @@
+source.fish
\ No newline at end of file
diff --git a/share/completions/source.fish b/share/completions/source.fish
new file mode 100644
index 000000000..dcb48a1ed
--- /dev/null
+++ b/share/completions/source.fish
@@ -0,0 +1 @@
+complete -c . -x -a "(__fish_complete_suffix .fish)"