Read Me
Web site maintenance
====================
Updating current version show at top right
------------------------------------------
Edit page-top.html. Change 'Current release:' in Header div.
Updating About / NEWS
---------------------
Edit /about/news.html
Updating About / Change Log
---------------------------
See Updating Documentation / README Files
Updating About / License
------------------------
See Updating Documentation / README Files
Updating Documentation / README Files
-------------------------------------
The main list of README files is in /docs/readmefiles.html.
Each README file has a .html file in /docs/ that has an include of the actual
text README file from /docs/readmefiles/
To update existing README files, just copy the updated files to /docs/readmefiles/:
cp /tmp/net-snmp-x.x.x/CHANGES .
cp /tmp/net-snmp-x.x.x/COPYING .
cp /tmp/net-snmp-x.x.x/ERRATA .
cp /tmp/net-snmp-x.x.x/INSTALL .
cp /tmp/net-snmp-x.x.x/NEWS .
cp /tmp/net-snmp-x.x.x/PORTING .
cp /tmp/net-snmp-x.x.x/README* .
cp /tmp/net-snmp-x.x.x/TODO .
cp /tmp/net-snmp-x.x.x/perl/SNMP/README perl/README
cp /tmp/net-snmp-x.x.x/perl/AnyData_SNMP/README perl/AnyData_SNMP/README
cp /tmp/net-snmp-x.x.x/perl/default_store/README perl/default_store/README
cp /tmp/net-snmp-x.x.x/perl/OID/README perl/OID/README
cp /tmp/net-snmp-x.x.x/perl/SNMP/README perl/SNMP/README
cp /tmp/net-snmp-x.x.x/perl/TrapReceiver/README perl/TrapReceiver/README
Next, run /tmp/net-snmp-x.x.x/local/html-textfile-fix.pl while inside the readmefiles
folder. This will change all < to <, > to > etc.
To add a new README file:
-copy file to /docs/readmefiles/
-create a .html file in /docs/ which includes the README file
-add an entry to html-textfile-fix.pl
-run html-textfile-fix.pl
Updating Documentation / FAQ
----------------------------
-cd (source dir)
-./configure
-make FAQ.html
-/tmp/net-snmp-x.x.x/local/html-add-header-footer.pl --section=documentation FAQ.html
-cd to base of htdocs
-cp /tmp/net-snmp-x.x.x/FAQ.html docs/
Updating Documentation / INSTALL
--------------------------------
See Updating Documentation / README Files
Updating Documentation / Man pages
----------------------------------
-cd (source dir)
-make sedscript
-cd (source dir)/man
-make all
-make install prefix=`pwd`
-mv man/man? ../
-make html
-find . -name '*.html' | ../local/html-add-header-footer.pl --section=documentation --body --tidy
-cd to base of htdocs
-cp /tmp/net-snmp-x.x.x/man/*.html docs/man/
While running make html, if you get the error 'missing a filing location for: ...', then the items
listed need to be added to the man_sections.txt file.
Updating Documentation / MIBS
-----------------------------
-install this version of Net-SNMP
-cd (source dir)/mibs
-make htmldir
-find html/. -name '*.html' | ../local/html-add-header-footer.pl --section=documentation --body
-cd to base of htdocs
-cp /tmp/net-snmp-5.4.1/mibs/html/*.html docs/mibs/
-cp /tmp/net-snmp-5.4.1/mibs/*.txt docs/mibs/
-cp /tmp/net-snmp-5.4.1/mibs/*.inc docs/mibs/
-chmod +x docs/mibs/*.html
Updating Development / API
--------------------------
-cd (source dir)
-make docs
-find docs/html/. -name '*.html' | local/html-add-header-footer.pl --section=development --body --tidy
-cp docs/html/*.html to web site /dev/agent
Web site folder descriptions
============================
party: Pictures from Net-SNMP meeting. Linked from -- in Net-SNMP logo
presentations: PowerPoint presentations etc
temp: Temp folder for testing etc
unsupported: ?