@elextr requested changes on this pull request.

A couple of changes.


In doc/geany.txt:

> @@ -1785,6 +1786,25 @@ This works basically the same as on other platforms::
     "c:\program files\geany\bin\geany" -g c:\mytags.php.tags c:\code\somefile.php
 
 
+Generating tags files using ctags
+*********************************
+Geany supports loading tag files generated using the ``ctags`` command-line
+tool from the universal-ctags project (https://github.com/universal-ctags/ctags).
+Even though Geany should work with any ctags file, it is recommended to use
+certain fields to give Geany some additional information. The recommended fields
+are ``EfiklsZSt``, so, for instance, to generate tags for all sources in the geany

delete "for instance" and comma after "directory"


In doc/geany.txt:

> +Generating tags files using ctags
+*********************************
+Geany supports loading tag files generated using the ``ctags`` command-line
+tool from the universal-ctags project (https://github.com/universal-ctags/ctags).
+Even though Geany should work with any ctags file, it is recommended to use
+certain fields to give Geany some additional information. The recommended fields
+are ``EfiklsZSt``, so, for instance, to generate tags for all sources in the geany
+directory, one can use::
+
+    ctags --fields=EfiklsZSt -o geany.c.tags -R geany
+
+Additional options may be given to the ``ctags`` tool, for instance, to restrict
+the generated tags file to some languages only, use certain tag kinds, etc.
+
+Note that when the ``l`` field (specifying the programming language for every tag)
+is enabled, the language of the tag is set based on this field instead of the

question, is it the tag or the symbol in Geany that gets the language specified?


In doc/geany.txt:

> @@ -1689,12 +1689,13 @@ Global tags files can have three different formats:
 * Pipe-separated format
 * CTags format
 
-The first line of global tags files should be a comment, introduced
-by ``#`` followed by a space and a string like ``format=pipe``,
-``format=ctags`` or ``format=tagmanager`` respectively, these are
+For the tagmanager or pipe-separated format, the first line of global tag files
+should be a comment, introduced by ``#`` followed by a space and a string like

delete "a string like", its not "like" it is exactly one or other IIUC


In doc/geany.txt:

>  case-sensitive.  This helps Geany to read the file properly. If this
 line is missing, Geany tries to auto-detect the used format but this
-might fail.
+might fail.  Tag files using the CTags format should be left unmodified in the

"used format" above s/b "format used"

(I know its not your change, but might as well fix it)


Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.Message ID: <geany/geany/pull/3049/review/1675440113@github.com>