Mirror/zeek
1
0
Fork 0
mirror of https://github.com/zeek/zeek.git synced 2025-10-02 14:48:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Improve Zeekygen output for long attribute expressions

Browse source 
Long inline-literals often don't wrap pleasantly in HTML renders and
we had a few &default or &deprecated attributes whose expressions
evaluate to a value long enough to warrant different formatting or
even truncation.
This commit is contained in:
Jon Siwek 2019-07-03 11:03:07 -07:00
parent c5c688054c
commit c03ef308c9
6 changed files with 43 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

44
src/Attr.cc
View file

@ -45,8 +45,33 @@ void Attr::Describe(ODesc* d) const
}
}
void Attr::DescribeReST(ODesc* d) const
void Attr::DescribeReST(ODesc* d, bool shorten) const
{
auto add_long_expr_string = [](ODesc* d, const std::string& s, bool shorten)
{
constexpr auto max_expr_chars = 32;
constexpr auto shortened_expr = "*...*";
if ( s.size() > max_expr_chars )
{
if ( shorten )
d->Add(shortened_expr);
else
{
// Long inline-literals likely won't wrap well in HTML render
d->Add("*");
d->Add(s);
d->Add("*");
}
}
else
{
d->Add("``");
d->Add(s);
d->Add("``");
}
};
d->Add(":zeek:attr:`");
AddTag(d);
d->Add("`");
@ -57,7 +82,6 @@ void Attr::DescribeReST(ODesc* d) const
d->Add("=");
d->SP();
if ( expr->Tag() == EXPR_NAME )
{
d->Add(":zeek:see:`");
@ -74,14 +98,15 @@ void Attr::DescribeReST(ODesc* d) const
else if ( expr->Tag() == EXPR_CONST )
{
d->Add("``");
expr->Describe(d);
d->Add("``");
ODesc dd;
dd.SetQuotes(1);
expr->Describe(&dd);
string s = dd.Description();
add_long_expr_string(d, s, shorten);
}
else
{
d->Add("``");
Val* v = expr->Eval(0);
ODesc dd;
v->Describe(&dd);
@ -92,8 +117,7 @@ void Attr::DescribeReST(ODesc* d) const
if ( s[i] == '\n' )
s[i] = ' ';
d->Add(s);
d->Add("``");
add_long_expr_string(d, s, shorten);
}
}
}
@ -211,14 +235,14 @@ void Attributes::Describe(ODesc* d) const
}
}
void Attributes::DescribeReST(ODesc* d) const
void Attributes::DescribeReST(ODesc* d, bool shorten) const
{
loop_over_list(*attrs, i)
{
if ( i > 0 )
d->Add(" ");
(*attrs)[i]->DescribeReST(d);
(*attrs)[i]->DescribeReST(d, shorten);
}
}