Documentazione per gli stili nelle risorse Android

Question

Ho provato ad aggiungere una documentazione ad alcuni stili nel mio codice. Il problema è che Android Studio non collega la documentazione direttamente ad un utilizzo dello stile.

Voglio dire, il semplice <! - Docu -> commento non crea la documentazione desiderata per lo stile.

<!-- Documentation --> 
<style name="graph" parent="font_graph_base"/> 

Ecco quello che voglio, come esempio per un attributo vista:

Questo è ciò che ottengo, se io uso il semplice < - -> commento, quello che voglio! è quello di compilare questa documentazione.

C'è un modo per farlo funzionare?

Answer 1

Okay, ho fatto un sacco di ricerche per questo, ma dovrò deluderti. Non penso che ci sia un modo per farlo. Anche gli stili utilizzati da Android non hanno documentazione. Penso che l'unica cosa che puoi fare è mettere i commenti sopra e navigare nello stile per vedere il tuo commento.

Tuttavia è possibile utilizzare i commenti come documentazione con attributi (attr). Se hai degli attributi metti semplicemente un commento normale <!-- --> sopra e apparirà come documentazione. Hai persino modi per sopprimere quel commento usando <eat-comment/>.