mirror of
https://github.com/ziglang/zig.git
synced 2024-11-15 00:26:57 +00:00
autodocs: improve first-line descriptions
This commit is contained in:
parent
583175dc1d
commit
b63667dda3
@ -2835,16 +2835,20 @@ var zigAnalysis;
|
||||
|
||||
function shortDescMarkdown(docs) {
|
||||
const trimmed_docs = docs.trim();
|
||||
let index = trimmed_docs.indexOf(".");
|
||||
if (index < 0) {
|
||||
index = trimmed_docs.indexOf("\n");
|
||||
if (index < 0) {
|
||||
index = trimmed_docs.length;
|
||||
}
|
||||
} else {
|
||||
index += 1; // include the period
|
||||
let index = trimmed_docs.indexOf("\n\n");
|
||||
let cut = false;
|
||||
|
||||
if (index < 0 || index > 80) {
|
||||
if (trimmed_docs.length > 80) {
|
||||
index = 80;
|
||||
cut = true;
|
||||
} else {
|
||||
index = trimmed_docs.length;
|
||||
}
|
||||
}
|
||||
const slice = trimmed_docs.slice(0, index);
|
||||
|
||||
let slice = trimmed_docs.slice(0, index);
|
||||
if (cut) slice += "...";
|
||||
return markdown(slice);
|
||||
}
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user