doc/index.html

   1 <!doctype html>
   2 <html lang="en">
   3 <head>
   4 <title>Svjatoslav Commons - Java library of commonly used functions</title>
   5 <!-- 2019-01-19 Sat 02:02 -->
   6 <meta charset="utf-8">
   7 <meta name="viewport" content="width=device-width, initial-scale=1">
   8 <meta name="generator" content="Org-mode">
   9 <meta name="author" content="Svjatoslav Agejenko">
  10 <link href="https://bootswatch.com/3/darkly/bootstrap.min.css" rel="stylesheet">
  11 <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
  12 <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.5/js/bootstrap.min.js"></script>
  13 <style type="text/css">
  14 footer {background-color: #111 !important;}
  15 pre {background-color: #111; color: #ccc;}
  16 </style>
  17 <style type="text/css">
  18 /* org mode styles on top of twbs */
  19
  20 html {
  21     position: relative;
  22     min-height: 100%;
  23 }
  24
  25 body {
  26     font-size: 18px;
  27     margin-bottom: 105px;
  28 }
  29
  30 footer {
  31     position: absolute;
  32     bottom: 0;
  33     width: 100%;
  34     height: 101px;
  35     background-color: #f5f5f5;
  36 }
  37
  38 footer > div {
  39     padding: 10px;
  40 }
  41
  42 footer p {
  43     margin: 0 0 5px;
  44     text-align: center;
  45     font-size: 16px;
  46 }
  47
  48 #table-of-contents {
  49     margin-top: 20px;
  50     margin-bottom: 20px;
  51 }
  52
  53 blockquote p {
  54     font-size: 18px;
  55 }
  56
  57 pre {
  58     font-size: 16px;
  59 }
  60
  61 .footpara {
  62     display: inline-block;
  63 }
  64
  65 figcaption {
  66   font-size: 16px;
  67   color: #666;
  68   font-style: italic;
  69   padding-bottom: 15px;
  70 }
  71
  72 /* from twbs docs */
  73
  74 .bs-docs-sidebar.affix {
  75     position: static;
  76 }
  77 @media (min-width: 768px) {
  78     .bs-docs-sidebar {
  79         padding-left: 20px;
  80     }
  81 }
  82
  83 /* All levels of nav */
  84 .bs-docs-sidebar .nav > li > a {
  85     display: block;
  86     padding: 4px 20px;
  87     font-size: 14px;
  88     font-weight: 500;
  89     color: #999;
  90 }
  91 .bs-docs-sidebar .nav > li > a:hover,
  92 .bs-docs-sidebar .nav > li > a:focus {
  93     padding-left: 19px;
  94     color: #A1283B;
  95     text-decoration: none;
  96     background-color: transparent;
  97     border-left: 1px solid #A1283B;
  98 }
  99 .bs-docs-sidebar .nav > .active > a,
 100 .bs-docs-sidebar .nav > .active:hover > a,
 101 .bs-docs-sidebar .nav > .active:focus > a {
 102     padding-left: 18px;
 103     font-weight: bold;
 104     color: #A1283B;
 105     background-color: transparent;
 106     border-left: 2px solid #A1283B;
 107 }
 108
 109 /* Nav: second level (shown on .active) */
 110 .bs-docs-sidebar .nav .nav {
 111     display: none; /* Hide by default, but at >768px, show it */
 112     padding-bottom: 10px;
 113 }
 114 .bs-docs-sidebar .nav .nav > li > a {
 115     padding-top: 1px;
 116     padding-bottom: 1px;
 117     padding-left: 30px;
 118     font-size: 12px;
 119     font-weight: normal;
 120 }
 121 .bs-docs-sidebar .nav .nav > li > a:hover,
 122 .bs-docs-sidebar .nav .nav > li > a:focus {
 123     padding-left: 29px;
 124 }
 125 .bs-docs-sidebar .nav .nav > .active > a,
 126 .bs-docs-sidebar .nav .nav > .active:hover > a,
 127 .bs-docs-sidebar .nav .nav > .active:focus > a {
 128     padding-left: 28px;
 129     font-weight: 500;
 130 }
 131
 132 /* Nav: third level (shown on .active) */
 133 .bs-docs-sidebar .nav .nav .nav {
 134     padding-bottom: 10px;
 135 }
 136 .bs-docs-sidebar .nav .nav .nav > li > a {
 137     padding-top: 1px;
 138     padding-bottom: 1px;
 139     padding-left: 40px;
 140     font-size: 12px;
 141     font-weight: normal;
 142 }
 143 .bs-docs-sidebar .nav .nav .nav > li > a:hover,
 144 .bs-docs-sidebar .nav .nav .nav > li > a:focus {
 145     padding-left: 39px;
 146 }
 147 .bs-docs-sidebar .nav .nav .nav > .active > a,
 148 .bs-docs-sidebar .nav .nav .nav > .active:hover > a,
 149 .bs-docs-sidebar .nav .nav .nav > .active:focus > a {
 150     padding-left: 38px;
 151     font-weight: 500;
 152 }
 153
 154 /* Show and affix the side nav when space allows it */
 155 @media (min-width: 992px) {
 156     .bs-docs-sidebar .nav > .active > ul {
 157         display: block;
 158     }
 159     /* Widen the fixed sidebar */
 160     .bs-docs-sidebar.affix,
 161     .bs-docs-sidebar.affix-bottom {
 162         width: 213px;
 163     }
 164     .bs-docs-sidebar.affix {
 165         position: fixed; /* Undo the static from mobile first approach */
 166         top: 20px;
 167     }
 168     .bs-docs-sidebar.affix-bottom {
 169         position: absolute; /* Undo the static from mobile first approach */
 170     }
 171     .bs-docs-sidebar.affix .bs-docs-sidenav,.bs-docs-sidebar.affix-bottom .bs-docs-sidenav {
 172         margin-top: 0;
 173         margin-bottom: 0
 174     }
 175 }
 176 @media (min-width: 1200px) {
 177     /* Widen the fixed sidebar again */
 178     .bs-docs-sidebar.affix-bottom,
 179     .bs-docs-sidebar.affix {
 180         width: 263px;
 181     }
 182 }
 183 </style>
 184 <script type="text/javascript">
 185 $(function() {
 186     'use strict';
 187
 188     $('.bs-docs-sidebar li').first().addClass('active');
 189
 190     $(document.body).scrollspy({target: '.bs-docs-sidebar'});
 191
 192     $('.bs-docs-sidebar').affix();
 193 });
 194 </script>
 195 </head>
 196 <body>
 197 <div id="content" class="container">
 198 <div class="row"><div class="col-md-9"><h1 class="title">Svjatoslav Commons - Java library of commonly used functions</h1>
 199
 200 <div id="outline-container-sec-1" class="outline-2">
 201 <h2 id="sec-1"><span class="section-number-2">1</span> General</h2>
 202 <div class="outline-text-2" id="text-1">
 203 <ul class="org-ul">
 204 <li>This program is free software: you can redistribute it and/or modify
 205 it under the terms of the <a href="https://www.gnu.org/licenses/lgpl.html">GNU Lesser General Public License</a> as
 206 published by the Free Software Foundation, either version 3 of the
 207 License, or (at your option) any later version.
 208 </li>
 209
 210 <li>Program author:
 211 <ul class="org-ul">
 212 <li>Svjatoslav Agejenko
 213 </li>
 214 <li>Homepage: <a href="https://svjatoslav.eu">https://svjatoslav.eu</a>
 215 </li>
 216 <li>Email: <a href="mailto://svjatoslav@svjatoslav.eu">mailto://svjatoslav@svjatoslav.eu</a>
 217 </li>
 218 </ul>
 219 </li>
 220
 221 <li><a href="https://www.svjatoslav.eu/projects/">Other software projects hosted at svjatoslav.eu</a>
 222 </li>
 223 </ul>
 224 </div>
 225
 226 <div id="outline-container-sec-1-1" class="outline-3">
 227 <h3 id="sec-1-1"><span class="section-number-3">1.1</span> Source code</h3>
 228 <div class="outline-text-3" id="text-1-1">
 229 <ul class="org-ul">
 230 <li><a href="https://www2.svjatoslav.eu/gitweb/?p=svjatoslav_commons.git;a=snapshot;h=HEAD;sf=tgz">Download latest snapshot in TAR GZ format</a>
 231 </li>
 232
 233 <li><a href="https://www2.svjatoslav.eu/gitweb/?p=svjatoslav_commons.git;a=summary">Browse Git repository online</a>
 234 </li>
 235
 236 <li>Clone Git repository using command:
 237 <pre class="example">
 238 git clone https://www2.svjatoslav.eu/git/svjatoslav_commons.git
 239
 240 </pre>
 241 </li>
 242
 243 <li>See <a href="https://www3.svjatoslav.eu/projects/svjatoslav_commons/apidocs/">JavaDoc</a>.
 244 </li>
 245 </ul>
 246 </div>
 247 </div>
 248 </div>
 249
 250 <div id="outline-container-sec-2" class="outline-2">
 251 <h2 id="sec-2"><span class="section-number-2">2</span> Library contents</h2>
 252 <div class="outline-text-2" id="text-2">
 253 <ul class="org-ul">
 254 <li>See <a href="https://www3.svjatoslav.eu/projects/svjatoslav_commons/apidocs/">JavaDoc</a>.
 255 </li>
 256
 257 <li>Commandline Interface helper
 258 <pre class="example">
 259 eu.svjatoslav.commons.commandline.CLIHelper
 260
 261 </pre>
 262 </li>
 263
 264 <li>Commandline arguments parser and validator.
 265 <pre class="example">
 266 eu.svjatoslav.commons.commandline.parameterparser
 267
 268 </pre>
 269 </li>
 270
 271 <li>Bit input and output streams.
 272 <pre class="example">
 273 eu.svjatoslav.commons.data.BitInputStream
 274 eu.svjatoslav.commons.data.BitOutputStream
 275
 276 </pre>
 277 </li>
 278
 279 <li>Slightly enhanced data input and output streams.
 280 <pre class="example">
 281 eu.svjatoslav.commons.data.EnhancedDataInputStream
 282 eu.svjatoslav.commons.data.EnhancedDataOutputStream
 283
 284 </pre>
 285 </li>
 286
 287 <li>Byte array to HEX string converter.
 288 <pre class="example">
 289 eu.svjatoslav.commons.data.HexConverter
 290
 291 </pre>
 292 </li>
 293
 294 <li>Utility that tries to quess user desktop directory. (Quite ugly and
 295 unreliable. Better solution is needed.)
 296 <pre class="example">
 297 eu.svjatoslav.commons.file.CommonPathResolver
 298
 299 </pre>
 300 </li>
 301
 302 <li>File path parser.
 303 <pre class="example">
 304 eu.svjatoslav.commons.file.FilePathParser
 305
 306 </pre>
 307 </li>
 308
 309 <li>File IO helper.
 310 <pre class="example">
 311 eu.svjatoslav.commons.file.IOHelper
 312
 313 </pre>
 314 </li>
 315
 316 <li>Graphical error dialog.
 317 <ul class="org-ul">
 318 <li>Reusable graphical dialog to capture and show program exceptions
 319 and associated program call stack traceback.
 320 <pre class="example">
 321 eu.svjatoslav.commons.gui.dialog.ExceptionDialog
 322
 323 </pre>
 324 </li>
 325 </ul>
 326 </li>
 327
 328 <li>Primitive and simple component to add navigation menus to the web
 329 sites.
 330 <pre class="example">
 331 eu.svjatoslav.commons.network.navigation
 332
 333 </pre>
 334 </li>
 335
 336 <li>String tokenizer.
 337 <pre class="example">
 338 eu.svjatoslav.commons.string.tokenizer
 339
 340 </pre>
 341 </li>
 342
 343 <li>Improved String, optimized for dealing with prefixes and suffixes.
 344 <pre class="example">
 345 eu.svjatoslav.commons.string.String2
 346
 347 </pre>
 348 </li>
 349
 350 <li>Wildcards matcher. (?, *)
 351 <pre class="example">
 352 eu.svjatoslav.commons.string.WildCardMatcher#match
 353
 354 </pre>
 355 </li>
 356 </ul>
 357 </div>
 358 </div>
 359
 360 <div id="outline-container-sec-3" class="outline-2">
 361 <h2 id="sec-3"><span class="section-number-2">3</span> Usage</h2>
 362 <div class="outline-text-2" id="text-3">
 363 <p>
 364 Instructions to embed svjatoslav-commons in your project as a library:
 365 </p>
 366
 367 <p>
 368 Maven pom.xml file snippet:
 369 </p>
 370
 371 <div class="org-src-container">
 372
 373 <pre class="src src-xml">&lt;dependencies&gt;
 374     ...
 375     &lt;dependency&gt;
 376         &lt;groupId&gt;eu.svjatoslav&lt;/groupId&gt;
 377         &lt;artifactId&gt;svjatoslavcommons&lt;/artifactId&gt;
 378         &lt;version&gt;1.7&lt;/version&gt;
 379     &lt;/dependency&gt;
 380     ...
 381 &lt;/dependencies&gt;
 382
 383
 384 &lt;repositories&gt;
 385     ...
 386     &lt;repository&gt;
 387         &lt;id&gt;svjatoslav.eu&lt;/id&gt;
 388         &lt;name&gt;Svjatoslav repository&lt;/name&gt;
 389         &lt;url&gt;http://www2.svjatoslav.eu/maven/&lt;/url&gt;
 390     &lt;/repository&gt;
 391     ...
 392 &lt;/repositories&gt;
 393 </pre>
 394 </div>
 395 </div>
 396 </div>
 397 </div><div class="col-md-3"><nav id="table-of-contents">
 398 <div id="text-table-of-contents" class="bs-docs-sidebar">
 399 <ul class="nav">
 400 <li><a href="#sec-1">1. General</a>
 401 <ul class="nav">
 402 <li><a href="#sec-1-1">1.1. Source code</a></li>
 403 </ul>
 404 </li>
 405 <li><a href="#sec-2">2. Library contents</a></li>
 406 <li><a href="#sec-3">3. Usage</a></li>
 407 </ul>
 408 </div>
 409 </nav>
 410 </div></div></div>
 411 <footer id="postamble" class="">
 412 <div><p class="author">Author: Svjatoslav Agejenko</p>
 413 <p class="date">Created: 2019-01-19 Sat 02:02</p>
 414 <p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 26.1 (<a href="http://orgmode.org">Org-mode</a> 9.1.9)</p>
 415 </div>
 416 </footer>
 417 </body>
 418 </html>