@elextr requested changes on this pull request.
A couple of changes.
> @@ -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"
> +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?
> @@ -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
> 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 or view it on GitHub:
https://github.com/geany/geany/pull/3049#pullrequestreview-1675440113
You are receiving this because you are subscribed to this thread.
Message ID: <geany/geany/pull/3049/review/[email protected]>
