fluffos/docs/efun/mudlib/author_stats.md
Yucong Sun c914f03d66
Add local search and documentation guide for docs site (#1221)
* docs: add local full-text search and a contributor README

Add @easyops-cn/docusaurus-search-local to the Docusaurus site so the
docs get an offline search bar (index built at build time, no external
service). English and zh-CN pages are both indexed, and matched terms
are highlighted on the target page.

Add docs/README.md describing the Docusaurus setup, local dev/build
commands, search behavior, directory layout, and gotchas; exclude it
from the published site alongside CLAUDE.md. Point the root README's
docs/ entry at it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE

* docs: remove dead framework leftovers, fix index generation, complete the nav

Delete the VitePress (.vitepress/) and Jekyll (_layouts/, css/) leftovers,
the one-shot migration scripts (fix_md_header.py, fix_seealso.py), and the
stale keywords.json snapshot; prune the matching .gitignore entries and
docusaurus exclude patterns.

Rewrite gen_index.py for Docusaurus: it emitted dead .html links and
legacy 'layout: doc' frontmatter, choked on non-markdown entries, and
dropped nested categories — regenerating an index would have broken it.
It now emits the extension-less links the site actually uses, links
nested category indexes (restoring apply/* on the zh-CN index), and
refuses to run on the docs root. Fix update_index.sh's copy-paste titles
(zh-CN efun/build were titled 'APPLY'), stop it clobbering the
hand-written lpc/index.md, and cover cli/. Regenerated indexes pick up
the missing driver/ffi-plan entry. add_missing_efuns.py now takes the
keywords.json path as an argument instead of requiring a stale copy.

Move CNAME and the Google site-verification file into static/ so they
actually reach the published build output.

Complete the sidebar: link the CLI category to cli/index and add the
missing portbind/symbol/generate_keywords pages, and expose the
previously orphaned stdlib section under Reference.

Promote onBrokenLinks to 'throw' now the build is warning-free, and drop
the empty Demo section from the landing page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE

* docs: strip legacy 'layout: doc' frontmatter from all pages

Mechanical sweep removing the Jekyll-era 'layout: doc' line from every
doc page's frontmatter (Docusaurus ignores it), and the matching line
from the templates in docs/CLAUDE.md so new pages don't reintroduce it.
No content changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-07-09 22:09:55 -04:00

2 KiB
Raw Permalink Blame History

title
mudlib / author_stats

author_stats

NAME

domain_stats() - returns statistics gathered on domains
author_stats() - returns statistics gathered on authors

SYNOPSIS

mapping domain_stats( string domain | void );
mapping author_stats( string domain | void );

DESCRIPTION

Both  domain_stats()  and author_stats() return information stored in a
mapping.  If no argument is specified, then information is returned  on
all  domains  (or  on  all  authors)  with  one map entry per domain or
author.  If an argument is specified, then a map is returned that  cor
responds  to  that  domain  or  author  with keys: moves, cost, errors,
heart_beats, worth, array_size, and objects.   Each  of  these  map  to
integer  values.   Moves  is the number of objects that have moved into
objects in the  given  domain.   Cost  is  the  number  of  evaluations
(eval_cost)  accumulated  by objects with the given domain (or author).
Errors is the number of errors  incurred  by  objects  with  the  given
domain.   Heart_beats  is the number of heartbeat calls made on objects
having the  given  domain.   Worth  is  the  value  maintained  by  the
add_worth(3)  efunction (this is usually used to keep track of how much
money a given wizard has given out vs. taken in).   Array_size  is  the
size  (in bytes) of the arrays allocated by the domain.  Objects is the
number of objects created by the given domain.   When  called  with  no
arguments, the returned mapping has a form like this:

    ([ domain0 : info0, domain1 : info1, ... ])

while info0 has the form:

    ([ "moves" : moves, "cost" : cost, "errors" : errors,
       "heart_beats" : heart_beats, "worth" : worth,
       "array_size" : array_size, "objects" : objects ])

When  called  with an argument, the returned mapping will have the form
of info0.

SEE ALSO

domain_file(4), author_file(4), set_author(3)