Comet/doc/oper-guide/ at main · snowfields.name/Comet · Tangled

snowfields.name / Comet

0

[READ-ONLY] Mirror of https://github.com/VibeDevelopers/Comet.

0

Comet / doc / oper-guide /

at main 12 files

Ryan Schmidt Remove some legacy cruft 2mo ago

Remove some legacy cruft - The hurt extension doesn't work well and is now supplanted by m_quarantine - ip_cloaking_old has been broken (causes segfaults) for years now, remove it - ip_cloaking_3.0 has hardcoded keys that require .c file edits to be secure. Anyone using it will probably maintain their fork of this file anyway, but it's not good for new people to use. Remove that too - Remove LOCOPS and umode +l entirely; they serve no useful purpose on unified networks. This also removes the no_locops extension since it is now useless

2 months ago

convert SGML guide to RST the rationale behind switching away from SGML/Docbook is the following: * SGML is hard to edit for humans * the output is not much prettier * the toolchain is not well supported and missing from the build * the build is not hooked into anywhere, no automation the reason why RST was chosen: * it allows for a strong structure like Docbook * the theme from Read The Docs is pretty * it also supports mobile devices * sphinx can easily output to PDF and ePUB formats * RST is plaintext that can be easily edited and diff'd * RST can be automatically built by ReadTheDocs and the toolchain is readily available * the output is also parsed by Github so documentation can be read straight from GH the reason why Markdown was not chosen: * the current strong structure would be hard to replicate * markdown is not standardized and output varies according to the implementation the docs were converted with Pandoc, using the following commands: mkdir oper-guide for source in sgml/oper-guide/*.sgml; do pandoc --toc -s -f docbook -t rst $source -o oper-guide/$(basename $source .sgml).rst done cd oper-guide sphinx-quickstart git add *.rst make.bat conf.py git add -f Makefile git rm -r ../sgml [merged from d4214e9445d9f9d0f0ede3e09a9f81deee9: doc/sgml/oper-guide/config.sgml]

9 years ago

Merge pull request #263 from anarcat/extban-doc point users towards HELP EXTBAN for inline help

8 years ago

review commands.rst style

9 years ago

doc: there is no _static directory

8 years ago

Remove some legacy cruft - The hurt extension doesn't work well and is now supplanted by m_quarantine - ip_cloaking_old has been broken (causes segfaults) for years now, remove it - ip_cloaking_3.0 has hardcoded keys that require .c file edits to be secure. Anyone using it will probably maintain their fork of this file anyway, but it's not good for new people to use. Remove that too - Remove LOCOPS and umode +l entirely; they serve no useful purpose on unified networks. This also removes the no_locops extension since it is now useless

2 months ago

fix duplicate headings, remove duplicate ToC

9 years ago

fix duplicate headings, remove duplicate ToC

9 years ago

convert SGML guide to RST the rationale behind switching away from SGML/Docbook is the following: * SGML is hard to edit for humans * the output is not much prettier * the toolchain is not well supported and missing from the build * the build is not hooked into anywhere, no automation the reason why RST was chosen: * it allows for a strong structure like Docbook * the theme from Read The Docs is pretty * it also supports mobile devices * sphinx can easily output to PDF and ePUB formats * RST is plaintext that can be easily edited and diff'd * RST can be automatically built by ReadTheDocs and the toolchain is readily available * the output is also parsed by Github so documentation can be read straight from GH the reason why Markdown was not chosen: * the current strong structure would be hard to replicate * markdown is not standardized and output varies according to the implementation the docs were converted with Pandoc, using the following commands: mkdir oper-guide for source in sgml/oper-guide/*.sgml; do pandoc --toc -s -f docbook -t rst $source -o oper-guide/$(basename $source .sgml).rst done cd oper-guide sphinx-quickstart git add *.rst make.bat conf.py git add -f Makefile git rm -r ../sgml [merged from d4214e9445d9f9d0f0ede3e09a9f81deee9: doc/sgml/oper-guide/config.sgml]

9 years ago

review oprivs.rst style

9 years ago

fix style in ucommands.rst

9 years ago

Remove some legacy cruft - The hurt extension doesn't work well and is now supplanted by m_quarantine - ip_cloaking_old has been broken (causes segfaults) for years now, remove it - ip_cloaking_3.0 has hardcoded keys that require .c file edits to be secure. Anyone using it will probably maintain their fork of this file anyway, but it's not good for new people to use. Remove that too - Remove LOCOPS and umode +l entirely; they serve no useful purpose on unified networks. This also removes the no_locops extension since it is now useless

2 months ago