revi-archive/phorge-phorge
1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-12-20 20:40:56 +01:00
Code Issues Releases Wiki Activity

Update symbols docs

Browse source 
Summary: Update manual to reflect T7984 and T8302.

Test Plan: Not many new red squigly lines.

Reviewers: joshuaspence, epriestley, #blessed_reviewers

Reviewed By: joshuaspence, epriestley, #blessed_reviewers

Subscribers: epriestley, Korvin

Differential Revision: https://secure.phabricator.com/D13551
This commit is contained in:
Aviv Eyal 2015-07-07 06:22:33 -07:00 committed by epriestley
parent b36d4025cb
commit 99fd5e99ef
1 changed files with 15 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
src/docs/user/userguide/diffusion_symbols.diviner
View file

@ -9,13 +9,14 @@ Phabricator can maintain a symbol index, which keeps track of where classes
and functions are defined in the codebase. Once you set up indexing, you can and functions are defined in the codebase. Once you set up indexing, you can
use the index to do things like: use the index to do things like:
- link symbol uses in Differential code reviews and Diffusion code browsing - jump to symbol definitions from Differential code reviews and Diffusion
to their definitions code browsing by ctrl-clicking (cmd-click on Mac) symbols
- allow you to search for symbols - search for symbols from the quick-search
- let the IRC bot answer questions like "Where is SomeClass?" - let the IRC bot answer questions like "Where is SomeClass?"
NOTE: Symbol indexing is somewhat new, and has broader support for PHP than for NOTE: Because this feature depends on the syntax highlighter, it will work
other languages. better for some languages than others. It currently works fairly well for PHP,
but your mileage may vary for other languages.
= Populating the Index = = Populating the Index =
@ -85,6 +86,12 @@ You can configure some more options by going to {nav Diffusion > (Select
Phabricator lists "Arcanist" and "libphutil" because it uses classes and Phabricator lists "Arcanist" and "libphutil" because it uses classes and
functions from these repositories. functions from these repositories.
NOTE: Because this feature depends on the syntax highlighter, it will work == External Symbols ==
better for some languages than others. It currently works fairly well for PHP,
but your mileage may vary for other languages. By @{article:Adding New Classes}, you can teach Phabricator
about symbols from the outside world.
Extend @{class:DiffusionExternalSymbolsSource}; Once loaded, your new
implementation will be used any time a symbol is queried.
See @{class:DiffusionPhpExternalSymbolsSource} and
@{class:DiffusionPythonExternalSymbolsSource} for example implementations.