{"id":28918010,"url":"https://github.com/larryv/mkvimball-sh","last_synced_at":"2026-04-27T18:31:24.169Z","repository":{"id":137551381,"uuid":"459813642","full_name":"larryv/mkvimball-sh","owner":"larryv","description":"A portable Bourne utility for creating vimball archives","archived":false,"fork":false,"pushed_at":"2023-06-27T00:37:01.000Z","size":149,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T01:06:12.081Z","etag":null,"topics":["bourne-shell","shell","vim","vimball"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/larryv.png","metadata":{"files":{"readme":".github/README.adoc","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"COPYING.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-02-16T01:44:06.000Z","updated_at":"2023-06-19T03:02:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"ffac463b-0ce3-4424-87fe-af99c9095817","html_url":"https://github.com/larryv/mkvimball-sh","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/larryv/mkvimball-sh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larryv%2Fmkvimball-sh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larryv%2Fmkvimball-sh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larryv%2Fmkvimball-sh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larryv%2Fmkvimball-sh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/larryv","download_url":"https://codeload.github.com/larryv/mkvimball-sh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larryv%2Fmkvimball-sh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32349348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T17:12:42.749Z","status":"ssl_error","status_checked_at":"2026-04-27T17:12:41.658Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bourne-shell","shell","vim","vimball"],"created_at":"2025-06-22T01:06:11.007Z","updated_at":"2026-04-27T18:31:24.157Z","avatar_url":"https://github.com/larryv.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"////\n.github/README.adoc\n-------------------\n\nSPDX-License-Identifier: CC0-1.0\n\nWritten in 2022-2023 by Lawrence Velázquez \u003cvq@larryv.me\u003e.\n\nTo the extent possible under law, the author has dedicated all copyright\nand related and neighboring rights to this software to the public domain\nworldwide.  This software is distributed without any warranty.\n\nYou should have received a copy of the CC0 Public Domain Dedication\nalong with this software.  If not, see\n\u003chttps://creativecommons.org/publicdomain/zero/1.0/\u003e.\n////\n\n\n= mkvimball-sh\n:source-language: sh\n\n:title-cc0: CC0 1.0 Universal Public Domain Dedication\nifdef::env-github[]\n:link-cc0: link:../COPYING.txt\nendif::[]\nifndef::env-github[]\n:link-cc0: https://creativecommons.org/publicdomain/zero/1.0/\n:title-cc0: Creative Commons - {title-cc0}\nendif::[]\n:title-posix: POSIX.1-2017\n:url-drchip: https://www.drchip.org/astronaut\n:url-posix: https://pubs.opengroup.org/onlinepubs/9699919799\n\nThis is a\n{link-cc0}[public-domain, title={title-cc0}]\nrewrite of Charles E. Campbell's\n`{url-drchip}/src/index.html#MKVIMBALL[mkvimball]`\nutility for creating\n{url-drchip}/vim/index.html#VIMBALL[vimball]\narchives.  Written in portable Bourne shell, it can serve as\na replacement for noninteractive uses on a wide range of Unix and\nUnix-like systems.  A shim is available for drop-in compatibility with\n`mkvimball`.\n\n// TODO: List some reasons why this is better than the original.\n\n\n== Requirements\n\n* A relatively recent Bourne or Bourne-compatible (including\n{url-posix}/utilities/V3_chap02.html[POSIX-conformant,\ntitle=\"{title-posix} - Volume 3, Chapter 2 ('Shell Command Language')\"])\nshell, available at `/bin/sh`.\n\n* The typical Unix utilities, plus a couple that could be considered\natypical:\n+\n--\n** `{url-posix}/utilities/m4.html[m4,\ntitle=\"{title-posix} - Volume 3, Chapter 4 ('Utilities - m4')\"]`\nfor creating the compatibility shim.\n** `{url-posix}/utilities/make.html[make,\ntitle=\"{title-posix} - Volume 3, Chapter 4 ('Utilities - make')\"]`\nfor installation.\n--\n+\n{url-posix}/utilities/V3_chap04.html[POSIX conformance,\ntitle=\"{title-posix} - Volume 3, Chapter 4 ('Utilities')\"]\nis ideal, but minor transgressions are fine.\n\n* https://www.shellcheck.net[ShellCheck] for optional testing.\n\n* https://asciidoctor.org[Asciidoctor] for regenerating the manual\npages.  Only necessary if modifying the documentation source.\n\n\n== Installation, etc.\n\nTo install/uninstall the `mkvimball-sh` utility to/from `/usr/local`\n(privileges required, presumably):\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make install\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make uninstall\n\nTo avoid overwriting the original `mkvimball`, the standard targets omit\nthe compatibility shim, which is also named `mkvimball`.  To install\nboth `mkvimball-sh` and the shim:\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make installshim\n\nTo uninstall the shim (but not `mkvimball-sh`):\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make uninstallshim\n\n:title-gmake-man: GNU Make Manual\n:title-gmake-man-cmdvars: {title-gmake-man} - \\\n    Variables for Specifying Commands\n:title-gmake-man-dirvars: {title-gmake-man} - \\\n    Variables for Installation Directories\n:url-gmake-man: https://www.gnu.org/software/make/manual/html_node\n:url-gmake-man-cmdvars: {url-gmake-man}/Command-Variables.html\n:url-gmake-man-dirvars: {url-gmake-man}/Directory-Variables.html\n\nTo use an installation prefix other than `/usr/local`, define the\n`{url-gmake-man-dirvars}#index-prefix[prefix,\ntitle={title-gmake-man-dirvars} - 'prefix']`\nmacro when invoking `make`.  For example:\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make prefix=/opt installshim\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make prefix=/opt uninstall uninstallshim\n\nTo run basic tests:\n\n[source]\ncd /path/to/this/repo \u0026\u0026 make check\n\nThe\n`{url-gmake-man-dirvars}#index-bindir[bindir,\ntitle={title-gmake-man-dirvars} - 'bindir']`,\n`{url-gmake-man-dirvars}[datarootdir,\ntitle={title-gmake-man-dirvars}]`,\n`{url-gmake-man-dirvars}#index-exec_005fprefix[exec_prefix,\ntitle={title-gmake-man-dirvars} - 'exec_prefix']`,\n`{url-gmake-man-dirvars}[man1dir,\ntitle={title-gmake-man-dirvars}]`,\nand\n`{url-gmake-man-dirvars}[mandir,\ntitle={title-gmake-man-dirvars}]`\nmacros are supported for unorthodox installation hierarchies.  The\n`{url-gmake-man}/DESTDIR.html[DESTDIR]`\nmacro is supported for staged installs.  The `ASCIIDOCTOR` (with\n`ASCIIDOCTORFLAGS`),\n`{url-gmake-man-cmdvars}[INSTALL,\ntitle={title-gmake-man-cmdvars}]`,\n`{url-gmake-man-cmdvars}[INSTALL_DATA,\ntitle={title-gmake-man-cmdvars}]`,\n`{url-gmake-man-cmdvars}[INSTALL_PROGRAM,\ntitle={title-gmake-man-cmdvars}]`,\n`M4` (with `M4FLAGS`),\nand\n`SHELLCHECK` (with `SHELLCHECKFLAGS`)\nmacros are supported for using alternate tools.\n\n\n== Usage\n\n[source]\nmkvimball-sh [-a] [-f archive] [--] [file ...]\n\nThe `mkvimball-sh` utility copies the contents of its input\n{url-posix}/basedefs/V1_chap03.html#tag_03_403[text files,\ntitle=\"{title-posix} - Volume 1, Chapter 3, Section 403 ('Text File')\"]\nto a vimball archive.  The input files can be specified as _file_\noperands or as a list of LF-terminated paths on standard input.  The\narchive is written to standard output or, if `-f` is specified, to\n_archive_.  If `-a` is specified, the archive header is omitted from the\noutput so it can be appended to an existing archive; if both `-a` and\n`-f` are specified, _archive_ is appended to instead of overwritten.\n\n[source]\nmkvimball archivebase file ...\n\nThe `mkvimball` shim provides drop-in compatibility with the original\n`mkvimball`.  It rejects _archivebase_ if it contains a \".\" character;\notherwise, it writes the archive to `__archivebase__.vba`.\n\nConsult the xref:../mkvimball-sh.adoc[man page] for more details.\n\n\n// TODO: Note some differences from the original?\n\n\n== Legal\n\nTo the extent possible under law, the author has\n{link-cc0}[dedicated, title={title-cc0}]\nall copyright and related and neighboring rights to this software to the\npublic domain worldwide.  This software is published from the United\nStates of America and distributed without any warranty.\n\nRefer to\nifdef::env-github[`link:../install-sh[install-sh]`]\nifndef::env-github[`install-sh`]\nfor its separate licensing terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarryv%2Fmkvimball-sh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flarryv%2Fmkvimball-sh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarryv%2Fmkvimball-sh/lists"}