JSDoc Documentation Generation and Configuration
1. Installation
# Global installation
npm i -g jsdoc
# Local installation
npm i -D jsdoc
2. Basic Usage
/**
* A sample variable declaration
* @type {number}
*/
var sampleVariable = 123;
/**
* A sample function
* @param {string} arg1 - First argument, string type
* @param {number} arg2 - Second argument, number type
* @return {boolean} ...
Posted on Tue, 26 May 2026 21:08:58 +0000 by bad_gui
Verilog Comment Conventions and TerosHDL VSCode Plugin
Overview
This article covers systematic comment conventions for Verilog code and the TerosHDL VSCode extension for automated documentation generation.
Comment Syntax Implementation
Verilog supports the same comment syntax as C/C++:
Single-line comments: // comment text Multi-line comments: /* comment block */
Two-Layer Comment Architecture
To a ...
Posted on Wed, 20 May 2026 03:54:31 +0000 by leatherback
Automated RTL Documentation Generator Using Pyverilog
A new project has been initiated on GitHub: https://github.com/sasasatori/APBRST/tree/main
APBRST: A Tool for Converting RTL to Specification Documents
Author: sasasatori, Contact: 2861704773@qq.com
Introduction
APBRST is designed to assist Verilog RTL engineers in automatically generating initial documentation from Verilog source files, thereb ...
Posted on Mon, 18 May 2026 18:51:34 +0000 by jonshutt
Essential Mathematical Notation for Markdown Documents
Inline and Display Formulas
Inline formulas are enclosed in single dollar signs: $E = mc^2$.
Display formulas use double dollar signs: $$\int_a^b f(x)dx$$.
For Typora users, enable inline math support via:
File → Preferences → Markdown → Markdown Extensions → Check "Inline Math"
Common Mathematical Symbols
Superscripts and Subscripts
...
Posted on Thu, 14 May 2026 12:12:20 +0000 by MnilinM
Essential Linux Command Documentation and Lookup Tools
Comprehensive Reference Documentation (man)
The man command accesses the system's manual pages, offering deep technical details regarding commands, kernel interfaces, configuration formats, and system calls. It is the primary resource for authoritative information within a Linux environment.
Manual Sections Overview
Manual pages are organized i ...
Posted on Sat, 09 May 2026 10:47:36 +0000 by einamiga
Custom Javadoc Tag for File Creation Timestamp
To embed a file creation timestamp in Javadoc documentation, define a custom tag and integrate it into your source comments. The standard Javadoc tool does not natively support dynamic timestamps, so the timestamp must be generated at build or documentation-generation time.
Begin by annotating your class with a custom @created tag in the Javado ...
Posted on Fri, 08 May 2026 23:02:49 +0000 by pseudonym