Cleanup and requirements

Help System Improvements and Documentation Updates

• Fixed directory handling in help_sys.sh process_scripts function
• Improved variable naming and error handling for directory operations
• Updated function documentation in docs/shdoc
• Enhanced markdown generation and cross-referencing
• Replaced missing requirements.txt
• Updated manifest.lst

This commit focuses on improving the help system's directory handling
and enhancing documentation generation across the project.

Fix for CWD/PWD

Some functions not respecting CWD and changing it and leaving you in the venvutil directory.

Lint cleaning

Linting

Errno was not working for errno 7

• Bug in errno.sh errno function number 7, E2BIG failed to parse.
• Simplified logic and dead code when no argument passed.

I suspect that the digit in E2BIG was sone on purpose by someone a long time ago to check parsing of macro processors. It happens to be the only errcode with a digit in it. So the regex was failing on RC=7.

Current clone behavior, and lint picking

Summary

• clan Current clone was not handling non-sequenced virtual environments correctly.
• Cleaned out the lint filter

Fixes and minor enhancements

Update worklog and CHANGELOG with recent shell include file enhancements

• Added detailed entries for improvements in errno.sh, util_funcs.sh, and venv_funcs.sh.
• Enhanced error handling, logging, and virtual environment management.
• Documented new functionalities and improvements in error message formatting.

Bug fix release

Fixed problem in warehouse where directories above destination did not exist (mkdir -p)

• Plans to change this with the first tar later.

Housekeeping

Removed a link due to Windsurf using .gitignore to exclude files from its view.

• The workaround of creating a symlink to a directory in .gitigniore in Windsurf, indeed bite me here.
• rRemoved links to external project files.

20241225-00 Release fixes many issues and adds new features.

This is a stable release. Major enhancements and changes in this release include the following, fro further information please have a look at the README and the CHANGELOG.

Core Functionality Enhancements and Documentation Updates

Major improvements:

• lenv now list the pip/conda managed VENV''s and has the last modification tme.
  • The listing may be sorted on mtime, or by name in ascending or descending order
  • The date and time may be displayed in long format
• Enhanced setup script with better error handling, validation, and rollback framework
• Improved shell function libraries with better error handling and logging
• Enhanced warehouse and chunkfile tools with robust error handling
• Updated documentation with comprehensive examples and cross-references
• Script for compiling NumPy linked to Apple silicon.

Specific changes:

1. Setup Script:

• Added proper exit codes and validation for critical operations
• Improved package configuration and manifest handling
• Added support for deprecated file removal
• Implemented rollback capability framework

2. Shell Functions:

• venv_funcs.sh: Enhanced VENV management with improved sorting and cloning
• errno.sh: Better POSIX error handling and message formatting
• help_sys.sh: Improved documentation system and function naming

3. Core Tools:

• warehouse.sh: Added symlink validation and path normalization
• chunkfile.py: Improved type hints and UTF-8 handling
• Added validation for chunk operations and error recovery

4. Error Handling:

• Enhanced error handling across all scripts with proper exit codes
• Improved logging with descriptive messages and debugging context
• Added validation for critical operations
• Enhanced error recovery mechanisms

5. Documentation:

• Added comprehensive guides for all tools
• Created visual documentation for chunk operations
• Updated implementation details and examples
• Enhanced cross-referencing between docs

Testing:

• Verified error handling paths
• Tested edge cases in file operations
• Validated recovery mechanisms
• Confirmed proper UTF-8 handling

Fixes to setup.sh

Implement warehouse and recall functionality, update dependencies, and improve script handling

• Added new functionalities for warehouse management with symlink creation.
• Implemented recall feature for directory retrieval from the warehouse.
• Updated genmd with new features for grouping related files in markdown.
• Converted c++, g++, and ld to hardlinks for unified updates.
• Combined warehouse.sh functionalities into a single script with warehouse and recall.
• Removed unnecessary dependencies from requirements.txt.
• Deleted obsolete files: venv-std-packages.txt and build-requirements.txt.
• Added requirements-std.txt in the modules directory.
• Updated changelog to reflect these changes.

Full Changelog: 20241211-Update...20241212-Update