:: Re: [DNG] Starting outline for the …
Página Inicial
Delete this message
Reply to this message
Autor: dvalin
Data:  
Para: dng
Assunto: Re: [DNG] Starting outline for the DNG Safe Programmer Certificate

On 30.07.21 11:28, spiralofhope wrote:> I also mean that if there are
any complex ideas or words, those can be
> explained in separate specific-documentation in the same way that

code
> does it.

My preferred method for nesting descriptive prose, and presenting the
whole on one page, is to use folding in vim. Over the decades, I've
accumulated around 420 pages of problem diagnoses and solutions,code
builds, toolchain builds, command options, little bits of howto, etc,
in defence against wetware RAM dropouts. (More frequent in my 60s.)
The initial view is a TOC:

                UNIX USER ENVIRONMENT &
TOOLS            73 P     
                TEXT / OFFICE TOOLS &
PRINTING                63 P     
                          DRAWING
TOOLS                                   
19 L     

                 LINUX SYSTEM
ADMINISTRATION                172 P     

                 PROGRAMMING & EMBEDDED
TOOLS        120 P 
                                            
CAD                                         
1 P     

                 LinuxCNC:        
EMC2:           CNC:                   13
P

The fifth TOC line, for example, expands to:
   
                          PROGRAMMING &
EMBEDDED TOOLS                       {{{
GNU Manuals:   http://www.gnu.org/manual/manual.html
ASSEMBLER:---------------------------GAS:------------ASM:----------------AS:  
5 P    
BINUTILS:------------------------------------------------------------------- 
63 L
BISON:-------------------------------YACC:----------------------------------  
4 P     
BITSCOPE:-------------------------------------------------------------------  
1 P
BOOT:    Debugging: |See BOOT
DEFAULTS:|                                      
2 P     
CONFIGURE:-------------------------------------------------------------CONF: 
15 L     
C:-----------------------------------CODE:---------------------------------- 
16 L
CTAGS:---------------------------------------------------------------------- 
29 L
ENDIAN:----------------------------------------------------------ENDIANNESS: 
29 L
FLEX:-----------------------------------------------------------------------  
2 P
GCC:--------------------------------- G++
-------------------------COMPILER:  30 P
GNU:-------------------------------CONTRIBUTING:------------------COPYRIGHT: 
51 L
LIBRARIES:-------------------------ARCHIVES-------------------------------AR: 
1 P
LINKER:---------------------------- man ld
----------------------------- LD:  14 P
Other
BINUTILS:                                                               
4 P
LINT:                                                                        
40 L
MAKE:---------------------------------------------------------------makefile  
2 P  
MALLOC:---------------------------------------------------------------------  
4 P
DDD:----------------------------------------------------------------DEBUGGER 
22 L
GDB:----------------------------------------------------------------DEBUGGER  
5 P
DEJAGNU:-------------------------------------------------------------DejaGnu 
46 L
...
And each of these expand further. The line/page counts are custom
scripted,so not obligatory. I've used folding markers, which contain
each fold, justlike a 'C' code block. There are other folding methods.
For quicker search  hits, I just capitalise any keyword and follow it
with a colon.A search hit opens the containing fold, even if it is
seven levels down.There's a lot to like, I find. (Including no damn
GUI within cooee.)
Erik
P.S. To explain words as code does it, we could use ctags, but would
need an
awk script to generate the tags file, I figure. ;-)