svn commit: r510799 - in head/www: firefox firefox-esr

[Jan Beich]

Author: jbeich
Date: Mon Sep  2 14:51:07 2019
New Revision: 510799
URL: https://svnweb.freebsd.org/changeset/ports/510799

Log:
  www/firefox: restore paragraph separators after r508913
  
  Each paragraph here must be separated as the text flow is independent.
  Give up and convert to Markdown which is readable as is.

Modified:
  head/www/firefox-esr/pkg-message   (contents, props changed)
  head/www/firefox/pkg-message   (contents, props changed)

Modified: head/www/firefox-esr/pkg-message
==============================================================================
--- head/www/firefox-esr/pkg-message	Mon Sep  2 14:31:50 2019	(r510798)
+++ head/www/firefox-esr/pkg-message	Mon Sep  2 14:51:07 2019	(r510799)
@@ -1,7 +1,10 @@
 [
 { type: install
   message: <<EOM
-Some features available on other platforms are not implemented:
+## Missing features
+
+Some features found on Windows, macOS and Linux are not implemented:
+
 - Native audio (requires OSS backend, feature parity with ALSA or PulseAudio)
 - Encrypted Media Extensions (requires Widevine CDM binary)
 - Process sandboxing (requires Capsicum backend)
@@ -11,34 +14,35 @@ Some features available on other platforms are not imp
 - Gamepad API (requires libusbhid backend)
 - WebVR (requires open source runtime)
 - TCP fast open
+- `about:networking` (requires link state notification)
 
+## Crashes on FreeBSD 11.2
 
+Web Content process may frequently crash due to a [kernel bug].
+Either upgrade to FreeBSD 11.3 or try the following workaround:
 
-On FreeBSD < 11.3 Web Content process may frequently crash due to bug 181741.
-If you cannot upgrade try applying the following workaround:
+    $ sysctl net.local.stream.recvspace=16384
 
-$ sysctl net.local.stream.recvspace=16384
+[kernel bug]: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=181741
 
+## Audio backend
 
+To select non-default audio backend open `about:config` page and
+create `media.cubeb.backend` preference. Supported values are: `alsa`,
+`jack`, `pulse`, `pulse-rust`, `sndio`. Currently used backend can be
+inspected on `about:support` page.
 
-To select non-default audio backend open about:config page and create
-media.cubeb.backend preference. Supported values are: alsa, jack,
-pulse, pulse-rust, sndio. Currently used backend can be inspected
-on about:support page.
-
-
-
-smb:// issues (Gvfs/GIO option):
+## smb:// issues
 Network group, machine, and share browsing does not work correctly.
 
-sftp:// (Gvfs/GIO option):
-Only sftp access using public key authentication works.  To easily
-setup public key authentication to "remote_host":
+## sftp://
+Only sftp access using public key authentication works. To easily
+setup public key authentication to `remote_host`:
 
-ssh-keygen
-cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
+    $ ssh-keygen
+    $ cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
 
-The SSH server on remote_host must allow pub key authentication.
+The SSH server on `remote_host` must allow pub key authentication.
 EOM
 }
 ]

Modified: head/www/firefox/pkg-message
==============================================================================
--- head/www/firefox/pkg-message	Mon Sep  2 14:31:50 2019	(r510798)
+++ head/www/firefox/pkg-message	Mon Sep  2 14:51:07 2019	(r510799)
@@ -1,7 +1,10 @@
 [
 { type: install
   message: <<EOM
-Some features available on other platforms are not implemented:
+## Missing features
+
+Some features found on Windows, macOS and Linux are not implemented:
+
 - Native audio (requires OSS backend, feature parity with ALSA or PulseAudio)
 - Encrypted Media Extensions (requires Widevine CDM binary)
 - Process sandboxing (requires Capsicum backend)
@@ -11,35 +14,35 @@ Some features available on other platforms are not imp
 - Gamepad API (requires libusbhid backend)
 - WebVR (requires open source runtime)
 - TCP fast open
-- about:networking (requires link state notification)
+- `about:networking` (requires link state notification)
 
+## Crashes on FreeBSD 11.2
 
+Web Content process may frequently crash due to a [kernel bug].
+Either upgrade to FreeBSD 11.3 or try the following workaround:
 
-On FreeBSD < 11.3 Web Content process may frequently crash due to bug 181741.
-If you cannot upgrade try applying the following workaround:
+    $ sysctl net.local.stream.recvspace=16384
 
-$ sysctl net.local.stream.recvspace=16384
+[kernel bug]: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=181741
 
+## Audio backend
 
+To select non-default audio backend open `about:config` page and
+create `media.cubeb.backend` preference. Supported values are: `alsa`,
+`jack`, `pulse`, `pulse-rust`, `sndio`. Currently used backend can be
+inspected on `about:support` page.
 
-To select non-default audio backend open about:config page and create
-media.cubeb.backend preference. Supported values are: alsa, jack,
-pulse, pulse-rust, sndio. Currently used backend can be inspected
-on about:support page.
-
-
-
-smb:// issues (Gvfs/GIO option):
+## smb:// issues
 Network group, machine, and share browsing does not work correctly.
 
-sftp:// (Gvfs/GIO option):
-Only sftp access using public key authentication works.  To easily
-setup public key authentication to "remote_host":
+## sftp://
+Only sftp access using public key authentication works. To easily
+setup public key authentication to `remote_host`:
 
-ssh-keygen
-cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
+    $ ssh-keygen
+    $ cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
 
-The SSH server on remote_host must allow pub key authentication.
+The SSH server on `remote_host` must allow pub key authentication.
 EOM
 }
 ]