wslutilities / documentation Goto Github PK

Windows Version

Windows 10

Windows Build Number

19045

WSL Version

Not Applicable

Distro Version

Debian 12 (bookworm)

WSL Utilities Version

N/A

Describe the bug

On the installation wiki, at https://wslutiliti.es/wslu/install.html
Under Debian and Kali, the directions go against the recommendations from Debian for using third party repositories ( https://wiki.debian.org/DebianRepository/UseThirdParty )

1. The directions have the user place the file in /etc/apt/trusted.gpg.d, when Debian strongly recommends not to
   From Debian

The certificate MUST NOT be placed in /etc/apt/trusted.gpg.d or loaded by apt-key add.

This is because /etc/apt/trusted.gpg.d is the global trust anchor for all of apt and this would cause all repositories to accept this third-party certificate, including those that don't have "signed-by"

2. The directions have them directly use the ASCII-Armored certificate, when they recommend dearmoring it first

users MAY be told to run a command to download the certificate, but because chances are the certificate being distributed is ASCII-Armored, it is best to unconditionally dearmor them

3. Entries placed in /etc/apt/sources.list

Entries MUST be added in the /etc/apt/sources.list.d directory using a shortened repository name (e.g. deriv.list)

Steps to Reproduce

1. Read directions for installation on Debian/Kali
2. Compare with recommendations from Debian

Expected behavior

1. To place the key in /usr/share/keyrings as recommended and reference the key file using "signed-by" in the source line
2. To store/use it locally dearmored
3. Store the entry in its own file inside /etc/apt/sources.list.d

Additional context

Here is a potential way to fix:

1. Change
   wget -O - https://pkg.wslutiliti.es/public.key | sudo tee -a /etc/apt/trusted.gpg.d/wslu.asc
   to
   wget -O - https://pkg.wslutiliti.es/public.key | sudo gpg -o /usr/share/keyrings/wslu-archive-keyring.pgp --dearmor

2. Change lines like:
   echo "deb https://pkg.wslutiliti.es/debian buster main" | sudo tee -a /etc/apt/sources.list
   to
   echo "deb [signed-by=/usr/share/keyrings/wslu-archive-keyring.pgp] https://pkg.wslutiliti.es/debian buster main" | sudo tee -a /etc/apt/sources.list.d/wslu.list

Code of Conduct

• I agree to follow this project's Code of Conduct

Windows Version

Windows 11

Windows Build Number

n/a

WSL Version

Not Applicable

Distro Version

n/a

WSL Utilities Version

n/a

Describe the bug

Your website install page indicates to run zypper up after adding the repositories, but before installing wslu
zypper up installs all available updates, and is not directly analogous to apt-get update

The correct command after adding repositories is
zypper ref

I couldn't figure out how to register on https://git.wedotstud.io/wslu/documentation so I can't prepare a PR to fix it.

Steps to Reproduce

n/a

Expected behavior

n/a

Additional context

n/a

Code of Conduct

• I agree to follow this project's Code of Conduct

First of all, thanks for this utils set, awesome work! It helps me on a daily basis now.

Many people use Emacs in WSL, as the windows version is kind of slow and half baked.
I wrote a small elisp function that lets you open the current buffer marked files in dired (the emacs file manager) through wslview.
(I bound it to shift-return in dired) Now I browse my whole work files using dired and I can open files in word. Like the unwashed masses use Eclipse.

Maybe you want to add that to the wiki?

(defun my/wslview-open(&optional @fname)
  "Use wslview to open file in Windows."
  (interactive)
  (let* (
         ($file-list
          (if @fname
              (progn (list @fname))
            (if (string-equal major-mode "dired-mode")
                (dired-get-marked-files)
              (list (buffer-file-name)))))
         ($do-it-p (if (<= (length $file-list) 5)
                       t
                     (y-or-n-p "Open more than 5 files? "))))
    (when $do-it-p
        (mapc
         (lambda ($fpath)
           (shell-command
            (concat "wslview " (shell-quote-argument $fpath))))  $file-list)
        (when (not (string-equal major-mode "dired-mode"))
            (revert-buffer)))))