Files
klammertext/mac/argument.h
Andy Kopra ef77f03584 Klammerset: the @@@klammerset construct, its search path, and const correctness
The @@@klammerset system command formally declares a klammerset — a
named, logically related group of klammer definitions — with an
operative, idempotent declaration (:requires and :files load in order
at the declaration point, relative to the declaring file). A bare
symbol given to ktext -k, kdesc --input, or :requires resolves to
x/x.k on the search path: the document's directory, then
KLAMMERTEXT_KLAMMERSETS, then KLAMMERTEXT_HOME; kdesc --klammerset
lists the available sets. sks/sks.k is the first declared klammerset,
so `-k sks` loads the SKS by name. The engine's lookup classes were
renamed *_set → *_registry to keep the two concepts apart, and the
whole C++ tree now follows standard const-correctness conventions.
tst/ gains klammerset_test.sh (18 cases).

(from dev 64b1abf23e56)
2026-07-30 23:50:07 +02:00

41 lines
1.2 KiB
C++

#pragma once
#include "argtype.h"
// The Parameter class describes both parameters (in definitions) and
// arguments (in applications). Parameters are the primary concept:
// a designer declares parameters, and a writer supplies arguments to
// fill them. The class is named for the definition side because
// definitions come first; the Argument alias is used at application sites.
class Parameter
{
public:
Parameter()
: m_name("_default")
, m_argtype(Argtype())
, m_optional(false)
, m_default("")
, m_loc()
, m_target()
{};
Parameter(const std::string& name, const Argtype& argtype, const Locator& loc,
bool optional=false, const std::string& default_value = "");
~Parameter() = default;
bool undefined() const { return m_name == "_default"; };
std::string m_name {};
Argtype m_argtype; // {};
bool m_optional {};
std::string m_default {};
// True when m_default was filled from the argument type's :default
// rather than declared in the klammer's parameter list (for kdesc
// provenance display).
bool m_default_from_type {};
Locator m_loc;
std::string m_target {};
};
using Argument = Parameter;