classdef_texi2cache
pkg-octave-doc: classdef_texi2cache (clsname)
pkg-octave-doc: classdef_texi2cache (clsname, options)
pkg-octave-doc: report = classdef_texi2cache (…)
Write a class and its documented members into this directory’s doc-cache.
clsname is a class, qualified by its package when it lives in one, as
in 'prob.NormalDistribution'. Its own entry and one per member are
written into the doc-cache of the current directory, and the
entries the class no longer has are dropped, so a method renamed inside a
class needs only the class named once.
The class file must live in the current directory, or in a +pkg
directory below it. A +pkg directory is never itself the place to
stand: a cache inside one can be read by nothing, so a namespaced class is
written from the directory holding the +pkg.
The members are the ones the class documents: its public constructor, the
methods declared in the class’s own file, and the properties reported by
properties, inherited ones included. This is what
classdef_texi2html publishes, so a class reads the same way online
and in lookfor, and it is not an arbitrary choice: help
resolves an inherited property on a subclass but not an inherited method, so
these are exactly the members a cache entry can be built for. Members of a
Hidden or private block are left out, as are those carrying no
texinfo help, each of the latter reported under MissingDocstring as
it is skipped.
options is a pkg_doc_options object. Its
IndexLocation property never decides what is written here: the class
named is always cached, and an INDEX given only adds a warning when
the class is not listed in it.
An inherited property is cached, its help text belonging to the superclass that declares it, but only the rules a renderer can apply are run on it: the rules that measure a file are left to the run that covers the file it is written in.
report is a struct with the fields 'cache', 'added',
'updated', 'removed', 'changed' and
'findings'. With no output requested the same information is
printed.
See also: package_texi2cache, folder_texi2cache, function_texi2cache, classdef_texi2html, pkg_doc_options
Source Code: classdef_texi2cache