Reference plugin file as canonical API documentation

autoload/fugitive.vim

@@ -1,6 +1,9 @@
 " Location:     autoload/fugitive.vim
 " Maintainer:   Tim Pope <http://tpo.pe/>
 
+" The functions contained within this file are for internal use only.  For the
+" official API, see the commented functions in plugin/fugitive.vim.
+
 if exists('g:autoloaded_fugitive')
   finish
 endif

doc/fugitive.txt

@@ -601,6 +601,10 @@ a statusline, this one matches the default when 'ruler' is set:
 >
         set statusline=%<%f\ %h%m%r%{FugitiveStatusline()}%=%-14.(%l,%c%V%)\ %P
 <
+API                                             *fugitive-api*
+
+Officially supported functions are documented inline in plugin/fugitive.vim.
+
 DEPRECATIONS                                    *fugitive-deprecated*
 
 The following commands are deprecated in favor of replacements that adhere to