Boilerplate

.gitattributes

@@ -1,2 +1,6 @@
 
 *.rs linguist-language=Rust
+
+*.html linguist-detectable=false
+*.sh linguist-detectable=false
+*.vimrc linguist-detectable=false

.gitignore

@@ -2,6 +2,8 @@
 # directories (by name)
 
 /_build/
+/_build-ci/
+/scripts/__pycache__/
 /scratch/
 /target/
 
@@ -13,8 +15,6 @@
 
 .DS_Store
 
-#Cargo.lock
-
 
 # files (by pattern)
 
@@ -24,3 +24,4 @@
 *.swp
 *.tmp
 *.zip
+

.vimrc

@@ -0,0 +1,70 @@
+" Synesis C/C++ project .vimrc — aligned with .sis/.vscode/c_cxx/settings.json
+
+set nocompatible
+filetype indent plugin on
+syntax enable
+set autoindent
+set backspace=indent,eol,start
+set hlsearch
+set incsearch
+set number
+
+" files.insertFinalNewline
+set eol
+set fixeol
+
+" editor.renderWhitespace: all
+set list
+set listchars=tab:->,trail:-,extends:>,precedes:<,nbsp:+
+
+" editor.detectIndentation: false — global defaults (editor.tabSize: 2, insertSpaces: false)
+set tabstop=2
+set shiftwidth=2
+set softtabstop=2
+set noexpandtab
+set colorcolumn=76
+
+" colorcolumn draws a full-column tint in Vim (not a VS Code-style 1px line).
+" Keep it subtle via the ColorColumn highlight group; reapply after colorscheme changes.
+if has('termguicolors')
+  " set termguicolors
+endif
+
+function! s:ConfigureColorColumn() abort
+  highlight ColorColumn ctermbg=236 guibg=#2a2a2a cterm=NONE gui=NONE
+endfunction
+
+call s:ConfigureColorColumn()
+autocmd ColorScheme * call s:ConfigureColorColumn()
+
+" files.trimTrailingWhitespace
+autocmd BufWritePre * %s/\s\+$//e
+
+augroup sis_c_cxx
+  autocmd!
+
+  " [c] / [cpp]
+  autocmd FileType c,cpp setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,64,68,72,76
+
+  " [rust]
+  autocmd FileType rs setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=76
+
+  " [cmake]
+  autocmd FileType cmake setlocal noexpandtab tabstop=4 shiftwidth=4 softtabstop=4
+
+  " [shellscript]
+  autocmd FileType sh,bash,zsh setlocal expandtab tabstop=2 shiftwidth=2 softtabstop=2 colorcolumn=60,76
+
+  " [bat]
+  autocmd FileType bat,dosbatch setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,76
+
+  " [json] / [markdown] / [yaml] / [ruby]
+  autocmd FileType json,markdown,yaml,ruby setlocal expandtab tabstop=2 shiftwidth=2 softtabstop=2
+
+  " [python]
+  autocmd FileType python setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,76
+
+  " [toml]
+  autocmd FileType toml setlocal noexpandtab tabstop=2 shiftwidth=2 softtabstop=2
+augroup END
+

.vscode/settings.json

@@ -1,38 +1,44 @@
 {
 	"[json]": {
-		"editor.tabSize": 2
+		"editor.insertSpaces": false,
+		"editor.tabSize": 2,
+	},
+	"[markdown]": {
+		"editor.insertSpaces": true,
+		"editor.tabSize": 2,
 	},
 	"[python]": {
 		"editor.insertSpaces": true,
 		"editor.rulers": [ 60, 76 ],
-		"editor.tabSize": 2
+		"editor.tabSize": 4,
 	},
 	"[ruby]": {
 		"editor.insertSpaces": true,
 		"editor.rulers": [ 60, 76 ],
-		"editor.tabSize": 2
+		"editor.tabSize": 2,
 	},
 	"[rust]": {
 		"editor.insertSpaces": true,
 		"editor.rulers": [ 60, 76 ],
-		"editor.tabSize": 4
+		"editor.tabSize": 4,
 	},
 	"[toml]": {
 		"editor.insertSpaces": false,
-		"editor.tabSize": 2
+		"editor.tabSize": 2,
 	},
 	"cmake.configureOnOpen": false,
 	"editor.detectIndentation": false,
 	"editor.insertSpaces": false,
 	"editor.renderWhitespace": "all",
+	"editor.rulers": [ 76 ],
 	"editor.tabSize": 2,
 	"files.insertFinalNewline": true,
 	"files.trimTrailingWhitespace": true,
 	"git.mergeEditor": false,
 	"rust-analyzer.cargo.noDefaultFeatures": true,
 	"rust-analyzer.cargo.features": [
-		"default"
+		"default",
 	],
 	"rust-analyzer.completion.autoimport.enable": false,
-	"rust-analyzer.showUnlinkedFileNotification": false
+	"rust-analyzer.showUnlinkedFileNotification": false,
 }

CHANGES.md

@@ -1,12 +1,15 @@
 # p99.Rust CHANGES <!-- omit in toc -->
 
 
-## 0.0.2 - 13th July 2026
+## 0.0.3 - 14th July 2026
+
+* standardised project boilerplate: (**.gitattributes**, **.gitignore**, **.vimrc**, **.vscode/settings.json**); project files (**CHANGES.md**, **EXAMPLES.md**, **NEWS.md**, **README.md**, **TODO.md**);
 
-#### Changes
 
-*   Added opt-in crate feature **`"binary-scaling"`** that replaces integer division with $2^{32}$ fixed-point binary scaling for all integer-based percentile queries (`value_at_p90()`, `value_at_p95()`, `value_at_p99()`, etc.), achieving a ~1.5x to 2x speedup with a small loss of accuracy;
-*   Added **`"null-feature"`** -- a no-op feature that has no effect but simplifies driver scripts that conditionally pass features;
+## 0.0.2 - 13th July 2026
+
+* added opt-in crate feature **`"binary-scaling"`** that replaces integer division with $2^{32}$ fixed-point binary scaling for all integer-based percentile queries (`#value_at_p90()`, `#value_at_p95()`, `#value_at_p99()`, etc.), achieving a ~1.5x to 2x speedup with a small loss of accuracy;
+* added **`"null-feature"`** -- a no-op feature that has no effect but simplifies driver scripts that conditionally pass features;
 
 
 ## 0.0.1 - 26th June 2026

Cargo.toml

@@ -24,7 +24,7 @@ license = "BSD-3-Clause"
 name = "p99"
 readme = "README.md"
 repository = "https://github.com/synesissoftware/p99.Rust"
-version = "0.0.2"
+version = "0.0.3"
 
 
 # ##########################################################

EXAMPLES.md

@@ -0,0 +1,9 @@
+# p99.Rust Examples <!-- omit it toc -->
+
+
+|Name|Source & Description|Summary|
+|---|---|---|
+|**build_histogram**|[examples/build_histogram/main.rs](/examples/build_histogram/main.rs)<br/>[examples/build_histogram.md](/examples/build_histogram.md)|Lists files in the current directory whose paths match one or more shell wildcard pattern(s), using `shwild::matches()`.|
+
+
+<!-- ########################### end of file ########################### -->

NEWS.md

@@ -0,0 +1,11 @@
+# p99.Rust - NEWS <!-- omit in toc -->
+
+| Date                  | News Item                                 |
+| --------------------- | ----------------------------------------- |
+| 14th July 2026        | p99.Rust 0.0.3 released                   |
+| 13th July 2026        | p99.Rust 0.0.2 released                   |
+| 26th June 2026        | p99.Rust 0.0.1 released                   |
+
+
+<!-- ########################### end of file ########################### -->
+

README.md

@@ -14,27 +14,29 @@ Low-cost generation of performance percentiles (p50, p90, p99, p99.9, etc.).
 - [Introduction](#introduction)
 - [How It Works](#how-it-works)
 - [Performance \& Trade-offs](#performance--trade-offs)
-	- [Performance Claims](#performance-claims)
-	- [Trade-offs \& Sacrifices](#trade-offs--sacrifices)
+  - [Performance Claims](#performance-claims)
+  - [Trade-offs \& Sacrifices](#trade-offs--sacrifices)
 - [Installation](#installation)
 - [Components](#components)
-	- [Constants](#constants)
-	- [Enumerations](#enumerations)
-	- [Features](#features)
-	- [Functions](#functions)
-	- [Macros](#macros)
-	- [Structures](#structures)
-		- [`Histogram`](#histogram)
-			- [Definition](#definition)
-			- [Minimal Example](#minimal-example)
-	- [Traits](#traits)
+  - [Constants](#constants)
+  - [Enumerations](#enumerations)
+  - [Features](#features)
+    - [Enabling `binary-scaling`](#enabling-binary-scaling)
+    - [Benchmark Results](#benchmark-results)
+  - [Functions](#functions)
+  - [Macros](#macros)
+  - [Structures](#structures)
+    - [`Histogram`](#histogram)
+      - [Definition](#definition)
+      - [Minimal Example](#minimal-example)
+  - [Traits](#traits)
 - [Examples](#examples)
 - [Project Information](#project-information)
-	- [Where to get help](#where-to-get-help)
-	- [Contribution guidelines](#contribution-guidelines)
-	- [Dependencies](#dependencies)
-		- [Dev Dependencies](#dev-dependencies)
-	- [License](#license)
+  - [Where to get help](#where-to-get-help)
+  - [Contribution guidelines](#contribution-guidelines)
+  - [Dependencies](#dependencies)
+    - [Dev Dependencies](#dev-dependencies)
+  - [License](#license)
 
 
 ## Introduction
@@ -104,9 +106,10 @@ No public enumerations are defined at this time.
 
 The following crate features are available:
 
-* **`binary-scaling`** *(opt-in)*: Replaces integer division in the integer-based percentile methods (`value_at_p90()`, `value_at_p95()`, `value_at_p99()`, etc.) with $2^{32}$ fixed-point binary scaling. Each percentile multiplier (e.g., `0.90` for p90) is pre-encoded as a `u32` constant and the target rank is computed via a single multiplication and a 32-bit right-shift, avoiding the cost of integer division entirely. This yields a **~1.5x to 2x speedup** for percentile queries with a negligible loss of accuracy (the scaled multiplier differs from the true value by less than $10^{-9}$). The generic `value_at_percentile(f64)` method is unaffected by this feature.
+* **`"binary-scaling"`** *(opt-in)*: Replaces integer division in the integer-based percentile methods (`#value_at_p90()`, `#value_at_p95()`, `#value_at_p99()`, etc.) with $2^{32}$ fixed-point binary scaling. Each percentile multiplier (e.g., `0.90` for p90) is pre-encoded as a `u32` constant and the target rank is computed via a single multiplication and a 32-bit right-shift, avoiding the cost of integer division entirely. This yields a **~1.5x to 2x speedup** for percentile queries with a negligible loss of accuracy (the scaled multiplier differs from the true value by less than $10^{-9}$). The generic `#value_at_percentile(f64)` method is unaffected by this feature;
+
+* **`"null-feature"`** *(opt-in)*: A no-op feature that has no effect on the compiled library. It exists to simplify driver scripts and CI pipelines that conditionally pass `--features` flags, allowing a feature list to always be present even when no real features are needed;
 
-* **`null-feature`** *(opt-in)*: A no-op feature that has no effect on the compiled library. It exists to simplify driver scripts and CI pipelines that conditionally pass `--features` flags, allowing a feature list to always be present even when no real features are needed.
 
 #### Enabling `binary-scaling`
 

TODO.md

@@ -1,13 +1,27 @@
-# p99.Rust <!-- omit in toc -->
+# p99.Rust - TODO <!-- omit in toc -->
 
 
 ## Table of Contents <!-- omit in toc -->
 
-- [TODOs](#todos)
+- [Functional improvements](#functional-improvements)
+- [Performance improvements](#performance-improvements)
+- [Packaging improvements](#packaging-improvements)
 
 
-## TODOs
+## Functional improvements
 
 - [x] ~~~`Debug` form~~~;
 - [x] ~~~binary scaling~~~;
 
+
+## Performance improvements
+
+- [x] ~~~binary scaling~~~;
+
+
+## Packaging improvements
+
+* \<none>
+
+
+<!-- ########################### end of file ########################### -->