buninu-linux 0.3.1 → 0.4.0

package/initramfs/usr/share/doc/buninu-linux/bunterm.md

@@ -0,0 +1,83 @@
+# bunterm — a graphical terminal on the Linux framebuffer
+
+`bunterm` runs a program on a pseudo-terminal and draws its screen on
+`/dev/fb0` with Skia (CanvasKit), so a real Linux console gets an
+xterm-compatible terminal with anti-aliased text, CJK, colour emoji, seamless
+box drawing and kitty graphics protocol images — no X11, Wayland or GPU.
+
+```sh
+bunterm                      # run /bin/sh on the console you are on
+bunterm /dev/tty1            # use virtual console 1 for graphics and keys
+bunterm --font-size 20
+bunterm -e bun /buninu/apps/jsmdcui/src/index.js --demo
+bunterm -h
+```
+
+The program's `TERM` is `xterm-256color`, `COLORTERM=truecolor`,
+`TERM_PROGRAM=bunterm` and `JSMDCUI_KITTY_MODE=extended` (so `jsmdcui` shows
+Markdown images without `--kitty`). When it exits, the console returns to
+text mode and `bunterm` exits with its status.
+
+## Options
+
+| Option | Meaning |
+| --- | --- |
+| `/dev/ttyN` | The virtual console to use for graphics and the keyboard. If another console is on screen, the display switches to this one first and back when `bunterm` exits. Without it the process's own console and stdin are used, so run it from a VT (not a serial line or a PTY). |
+| `-e command [argument...]` | The program to run; everything after `-e` belongs to it. Default `/bin/sh`. |
+| `--font-size N` | Font size in pixels (default 16). The cell is 0.6 × N wide and 1.16 × N tall with DejaVu Sans Mono, so 1024×768 at 16 px gives 106 × 41 cells. |
+| `--line-height F` | Multiplies the cell height (default 1). |
+| `--fb /dev/fbN` | The framebuffer device (default `/dev/fb0`). |
+| `--no-blink` | A steady cursor. |
+
+## What is drawn
+
+- **Text** comes from `/usr/share/fonts`: DejaVu Sans Mono (regular and
+  bold) sets the grid; Noto Sans CJK TC, Noto Color Emoji (+ Flags) and Noto
+  Sans Symbols fill in what it lacks. A glyph is centred in the one or two
+  cells the terminal assigned it; wide characters take two.
+- **Box drawing, block elements, shades and Powerline symbols** (U+2500–259F,
+  U+E0A0–E0BF, U+1FB70–1FB97) are drawn as vectors, ported from xterm.js, so
+  they join without seams at any size.
+- **Attributes**: 16 / 256 / 24-bit colours, bold (brighter for the eight base
+  colours), italic, dim, underline, strikethrough, inverse, invisible.
+- **Grapheme clusters** such as 🇹🇼 and 👨‍👩‍👧 occupy one cell each (xterm.js's
+  unicode-graphemes addon) and are shaped by Skia's paragraph engine.
+- **Images**: the kitty graphics protocol (`ESC _ G … ESC \`) with direct
+  transmission (`t=d`), PNG (`f=100`) or raw RGB/RGBA (`f=24`/`32`), zlib
+  (`o=z`), chunking (`m=`), cropping (`x,y,w,h`), sizing in cells (`c,r`),
+  cell offsets (`X,Y`), placements (`p=`), deletion (`a=d`) and queries
+  (`a=q`). An image is anchored to its line and scrolls with the text; on the
+  alternate screen it stays at its row and is removed when the program
+  leaves that screen. Any encoding Skia decodes (PNG, JPEG, WebP, GIF) is
+  accepted under `f=100`, as with jsgotty's `U=` extension.
+
+## Keyboard
+
+The console stays in the kernel's translated keyboard mode, so
+`Ctrl-Alt-F2` and friends still switch consoles; coming back repaints the
+screen. A few console-specific
+sequences are rewritten to xterm's (`F1`–`F5`, `Home`, `End`), and arrow keys
+follow the program's application cursor mode.
+
+## Limits
+
+- Needs a framebuffer: `linux-lts` has one built in, while the default
+  `linux-virt` builds it as modules the image does not ship, so build with
+  `--linux-lts` or `--real` (efifb/simpledrm from UEFI).
+- No mouse, no selection, no scrollback viewing (the buffer keeps 1000
+  lines for programs that query it).
+- A program that prints a terminal reply while the tty echoes (that is, one
+  not in raw mode) will see the reply echoed, as on any terminal.
+- Kitty images are drawn above text; `z` ordering below text and animation
+  frames are not implemented, and file transmission (`t=f`/`t=t`) works only
+  for files under `/tmp`, `/dev/shm` or `$TMPDIR`.
+- One framebuffer, one session. For panes and tabs run `jsmdcui` inside it.
+
+## See also
+
+- `/lib/bunterm/terminal.js` — `createSession()` and `runTerminal()`, the
+  pieces `bunterm` is built from
+- `/lib/canvas.js` — CanvasKit on the framebuffer (`canvas.md`)
+- `/lib/fbdev.js` — the framebuffer itself (`fbdev.md`)
+- `/buninu/apps/jsgotty/gotty.js` — the PTY backend and kitty packet parser
+  that are reused

package/initramfs/usr/share/doc/buninu-linux/canvas.md

@@ -0,0 +1,91 @@
+# canvas — CanvasKit (Skia) on the Linux framebuffer
+
+`/lib/canvas.js` runs Skia, compiled to WebAssembly as CanvasKit, on top of
+`/lib/fbdev.js`. Skia rasterizes straight into a buffer that already has the
+framebuffer's pixel layout, so a frame reaches `/dev/fb0` with one `memcpy`
+and no per-pixel conversion in JavaScript.
+
+## Drawing with Skia
+
+```js
+import { runGraphics } from "/lib/fbdev.js";
+import { loadCanvasKit, openCanvas, loadFontSet } from "/lib/canvas.js";
+
+const CanvasKit = await loadCanvasKit();
+const fonts = loadFontSet(CanvasKit, "ui");
+
+await runGraphics(async (display, { onRestore }) => {
+  const screen = openCanvas(CanvasKit, display);
+  const paint = new CanvasKit.Paint();
+  paint.setAntiAlias(true);
+  paint.setColor(CanvasKit.Color(64, 200, 255));
+  const font = new CanvasKit.Font(fonts.regular, 32);
+
+  screen.canvas.clear(CanvasKit.BLACK);
+  screen.canvas.drawCircle(display.width / 2, display.height / 2, 120, paint);
+  screen.canvas.drawText("Buninu 你好 😀", 40, 60, paint, font);
+  screen.flush();
+
+  await new Promise((resolve) => setTimeout(resolve, 3000));
+  screen.close();
+});
+```
+
+`screen.canvas` is a Skia `Canvas` with the full CanvasKit API: paths,
+gradients, shaders, image filters, `drawImage`, `drawGlyphs`, `Paragraph`
+layout with font fallback, PNG/JPEG decoding, and so on.
+
+## Exports
+
+| Export | Purpose |
+| --- | --- |
+| `loadCanvasKit()` | Loads `/lib/canvaskit/canvaskit.wasm` once per process and resolves to the `CanvasKit` object. The wasm heap starts at 128 MiB. |
+| `openCanvas(CanvasKit, display)` | Binds a raster surface to an open `Framebuffer`. Returns `{ canvas, surface, width, height, colorType, flush(), close() }`. While open, `display.pixels` is the surface's own memory, so `drawLine()`, `fillPolygon()` and `flush()` from `fbdev.js` keep working on the same frame. `close()` hands the last frame back to the JavaScript buffer. |
+| `pickColorType(CanvasKit, display)` | The Skia `ColorType` matching the framebuffer: `BGRA_8888` for the usual 32-bit XRGB (efifb, simpledrm), `RGBA_8888`, `RGB_565`; `null` for anything else, which `openCanvas` rejects. |
+| `loadFontSet(CanvasKit, name)` | A font set from `/usr/share/fonts/fonts.json` (`"terminal"` or `"ui"`) as `{ regular, bold, fallback, typefaces, fontMgr, families, delete() }`. `fontMgr` and `families` are what `ParagraphStyle` wants; a collection such as Noto Sans CJK registers every face and yields its preferred one (TC). |
+| `fontCatalogue()`, `fontPath(name)`, `loadFontData(name)` | The parsed `fonts.json`, a font's path, and its bytes (cached). |
+
+## Formats
+
+The framebuffer reports its channels as bit offsets. Skia can rasterize
+directly into three of the layouts Linux uses:
+
+| Framebuffer | Skia |
+| --- | --- |
+| 32 bpp, red@16 green@8 blue@0 (XRGB8888) | `BGRA_8888` |
+| 32 bpp, red@0 green@8 blue@16 (XBGR8888) | `RGBA_8888` |
+| 16 bpp, 5-6-5 | `RGB_565` |
+
+For a 24 bpp or paletted framebuffer, draw with the HTML canvas emulation
+instead and copy through `blitImageData()`:
+
+```js
+const canvas = CanvasKit.MakeCanvas(display.width, display.height);
+const ctx = canvas.getContext("2d");
+ctx.fillStyle = "#40c8ff";
+ctx.fillRect(0, 0, 200, 100);
+blitImageData(display, ctx.getImageData(0, 0, display.width, display.height));
+flush(display);
+```
+
+That path converts every pixel in JavaScript and is fine for static screens.
+
+## Fonts
+
+`/usr/share/fonts/fonts.json` lists the bundled files and two sets:
+
+| Set | Regular | Fallback order |
+| --- | --- | --- |
+| `terminal` | DejaVu Sans Mono (+ Bold) | Noto Color Emoji, Noto Color Emoji Flags, Noto Sans CJK, Noto Sans Symbols, Noto Sans Symbols2 |
+| `ui` | Roboto | Noto Sans CJK, Noto Color Emoji, Noto Color Emoji Flags, Noto Sans Symbols, Noto Sans Symbols2 |
+
+Files load on first use and are copied into the wasm heap; the CJK
+collection is 32 MiB, so a program that never draws CJK text should not
+load a set containing it. Each file's license sits beside it.
+
+## See also
+
+- `/lib/canvas.js`, `/lib/canvaskit/` (CanvasKit 0.41.1, BSD-3-Clause)
+- `/lib/fbdev.js` — `fbdev.md`
+- `/lib/bunterm/` — the terminal built on this (`bunterm.md`)
+- CanvasKit API: https://skia.org/docs/user/modules/canvaskit/

package/initramfs/usr/share/doc/buninu-linux/fbdev.md

@@ -0,0 +1,113 @@
+# fbdev — draw directly on the Linux framebuffer
+
+`/lib/fbdev.js` is both an importable drawing module and a small executable
+demo. It uses `/dev/fb0`, framebuffer ioctls, a shared `mmap`, and `KDSETMODE`
+through Bun FFI; it does not require X11, Wayland, SDL, or a window manager.
+
+## Demo
+
+Run it on Buninu's physical Linux console:
+
+```sh
+bun /lib/fbdev.js
+```
+
+The demo switches the active console to graphics mode, clears the framebuffer,
+draws a cyan triangle, and waits. Press any key to restore text mode and exit.
+Ordinary failures, direct process exit, `SIGHUP`, `SIGINT`, `SIGQUIT`, and
+`SIGTERM` also restore the prior keyboard raw state and attempt to return the
+console to text mode.
+
+Each repeatable `-p`/`--points` supplies one polygon as x,y coordinate pairs:
+
+```sh
+bun /lib/fbdev.js -p '100,50 40,250 300,250'
+bun /lib/fbdev.js \
+  -p '100,50 40,250 300,250' \
+  -p '400,80 350,220 450,220'
+```
+
+Every occurrence draws a separate filled polygon. Comma and whitespace
+separators may be mixed inside its quoted value; the clearest form uses a
+comma within each `x,y` point and spaces between points. If one polygon
+contains an odd number of numeric values, its final unpaired value is ignored.
+A `-p` containing only one number is therefore ignored as a whole. Each
+non-empty polygon needs at least three complete points; more than three points
+remain one polygon rather than starting another. If no drawable `-p` remains,
+the demo draws its default triangle.
+
+## JavaScript API
+
+```js
+import {
+  openFramebuffer,
+  clear,
+  drawPoint,
+  drawLine,
+  drawLines,
+  fillPolygon,
+  flush,
+} from "/lib/fbdev.js";
+
+const display = openFramebuffer();
+try {
+  clear(display);
+  fillPolygon(display, [[100, 50], [40, 250], [300, 250]], {
+    r: 64, g: 200, b: 255, a: 255,
+  });
+  drawLine(display, 0, 0, display.width - 1, display.height - 1, {
+    r: 255, g: 255, b: 255,
+  });
+  flush(display);
+} finally {
+  display.close();
+}
+```
+
+The API uses short drawing names because it operates on a framebuffer rather
+than an X11 `Display`. Colours are `{ r, g, b, a }` objects.
+
+### Export reference
+
+| Export | Purpose |
+| --- | --- |
+| `Framebuffer`, `openFramebuffer(path?)` | Open and describe a packed-pixel framebuffer. |
+| `normalizePoints(values)` | Accept flat numbers, `[x,y]` arrays, or `{x,y}` objects. An unpaired flat value is ignored. |
+| `parsePoints(strings)` | Parse comma/whitespace-separated CLI-style coordinates. |
+| `drawPoint(display, x, y, color?)` | Draw one clipped pixel. |
+| `drawLine(display, x1, y1, x2, y2, color?)` | Draw a clipped Bresenham line. |
+| `drawLines(display, points, color?, close?)` | Join a sequence of points. |
+| `fillPolygon(display, points, color?)` | Fill a polygon with the even-odd scanline rule. |
+| `clear(display, color?)` | Fill the in-memory frame, black by default. |
+| `flush(display)` | Copy the in-memory frame to the shared `/dev/fb0` mapping and synchronize it. |
+| `blitImageData(display, imageData, x?, y?)` | Copy an RGBA `ImageData` (for example from CanvasKit's HTML canvas emulation) into the frame, converting to the framebuffer's format and clipping. |
+| `openConsole`, `setConsoleGraphics`, `setConsoleText` | Explicit Linux virtual-console control for callers that need it. |
+| `activeConsole(console)`, `activateConsole(console, n)`, `consoleNumber(path)` | `VT_GETSTATE` / `VT_ACTIVATE` + `VT_WAITACTIVE`, and the number in a `/dev/ttyN` path. |
+| `watchConsoleSwitches(console, onAcquire)` | `VT_SETMODE` with `VT_PROCESS`: answers the kernel's switch-away and switch-back signals and calls `onAcquire` when the display returns. Returns a function restoring automatic switching. |
+| `runGraphics(draw, { device, console, switchConsole }?)` | Open the framebuffer, put the console in graphics mode, run `await draw(display, { console, onRestore, onAcquire })`, and restore text mode however the call ends (return, throw, `process.exit()`, `SIGHUP`/`SIGINT`/`SIGQUIT`/`SIGTERM`). `console` lists console devices to try, such as `["/dev/tty1"]`; when the one opened is a `/dev/ttyN` other than the console on screen, the display is switched to it first and back afterwards (`switchConsole: false` disables this). Console switches with Ctrl-Alt-Fn keep working; `onAcquire(callback)` runs when the display comes back so the caller can repaint, and `onRestore(callback)` registers cleanup to run before text mode returns. |
+| `runDemo({ polygons, device }?)` | Run the CLI demo through `runGraphics()`. Each item in `polygons` is drawn separately. |
+
+The module supports 16-, 24-, and 32-bit packed-pixel framebuffers and uses
+the kernel-reported stride, offsets, and RGB bitfields. Paletted and unusual
+non-packed framebuffer formats are rejected rather than drawn incorrectly.
+
+## Operational limits
+
+- Run the demo from a real Linux virtual console. A PTY, serial console, SSH
+  session, or terminal pane cannot accept `KDSETMODE`.
+- The framebuffer device and active virtual console must be accessible to the
+  process; Buninu normally runs as root.
+- Imported drawing calls modify an in-memory frame until `flush()` is called.
+- Importing the module does not switch console mode. Only `runDemo()` or an
+  explicit `setConsoleGraphics()` call does so.
+- No userspace cleanup can run after `SIGKILL`, a kernel panic, power loss, or
+  a native runtime crash. If one leaves the virtual console in graphics mode,
+  switch to another VT or reboot to recover it.
+
+## See also
+
+- Source: `/lib/fbdev.js`
+- Shared native binding: `/lib/dlopen.js`
+- Skia on this framebuffer: `/lib/canvas.js` (`canvas.md`); the terminal
+  built on both: `bunterm`
+- Linux UAPI: `linux/fb.h` and `linux/kd.h`

package/initramfs/usr/share/fonts/LICENSE-Apache-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/initramfs/usr/share/fonts/LICENSE-DejaVu.txt

@@ -0,0 +1,44 @@
+Bitstream Vera License (DejaVu Sans Mono; DejaVu changes are in the public domain)
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved.
+Bitstream Vera is a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute the
+Font Software, including without limitation the rights to use, copy, merge,
+publish, distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright and trademark notices and this permission notice shall
+be included in all copies of one or more of the Font Software typefaces.
+
+The Font Software may be modified, altered, or added to, and in particular
+the designs of glyphs or characters in the Fonts may be modified and
+additional glyphs or characters may be added to the Fonts, only if the fonts
+are renamed to names not containing either the words "Bitstream" or the word
+"Vera".
+
+This License becomes null and void to the extent applicable to Fonts or Font
+Software that has been modified and is distributed under the "Bitstream
+Vera" names.
+
+The Font Software may be sold as part of a larger software package but no
+copy of one or more of the Font Software typefaces may be sold by itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
+FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
+ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
+FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font Software
+without prior written authorization from the Gnome Foundation or Bitstream
+Inc., respectively. For further information, contact: fonts at gnome dot
+org.

package/initramfs/usr/share/fonts/LICENSE-OFL-1.1.txt

@@ -0,0 +1,91 @@
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to provide
+a free and open framework in which fonts may be shared and improved in
+partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+DEFINITIONS
+
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components
+as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to,
+deleting, or substituting -- in part or in whole -- any of the
+components of the Original Version, by changing formats or by porting
+the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer
+or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in
+Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the
+corresponding Copyright Holder. This restriction only applies to the
+primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must
+be distributed entirely under this license, and must not be distributed
+under any other license. The requirement for fonts to remain under this
+license does not apply to any document created using the Font Software.
+
+TERMINATION
+
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+