Re: "OpenBSD Doc" App idea

2023-09-10 Thread Daniele B.
Unfortunately, I'm not an app guy. Hopeing anyone
is listening.

As I live my spare time with the tablet very handy
and I found some nice stuff for Unix I launched the idea.

Indeed, I continue to read you. But I already expressed
my thoughts around the app.. if I miss to reply to
some of your suggestions pls don't mind it.

Thx to all.
-- Daniele Bonini

Sep 10, 2023 07:38:04 Stuart Longland VK4MSL :

> Nothing stopping you from writing one.



Re: "OpenBSD Doc" App idea

2023-09-09 Thread Stuart Longland VK4MSL

On 8/9/23 00:27, Daniele B. wrote:

Just pushing myself over any device limit..
I just searched the App Stores for "Unix" and related ones
and wondering if we can hope to have an "OpenBSD Doc"
app beside a "FreeBSD Doc" app anytime soon?

Anyone's offer? Yes I'm talking to you.. ;D


Nothing stopping you from writing one.  About the only thing you can't 
do without prior permission is imply any sort of "official" status for 
said software.  Mark it clearly as being an unofficial third-party tool, 
and you shouldn't have any problems legally.  (If in doubt, consult a 
lawyer.)


Having one that pulls the latest docs from a CVS mirror then renders 
them on the fly could be nice I guess if done well.  If done poorly, 
it'll be a nightmare for all concerned (CVS mirror admins included).


Another option might be to pull the docs from the Github mirror.  Sure, 
won't be 100% latest, since the official upstream is CVS with the Github 
mirror a "best effort" secondary concern… but at least if you hammer it 
with a poorly written client, it'll be Microsoft's problem not an issue 
for the OpenBSD mirror admins.


The rest of us can just use the website or man pages the way we've 
always done.

--
Stuart Longland (aka Redhatter, VK4MSL)

I haven't lost my mind...
  ...it's backed up on a tape somewhere.



Re: "OpenBSD Doc" App idea

2023-09-09 Thread John Batteen
Not quite.  Haikus have a 5-7-5 pattern.  But, with a few subtle 
modifications, it can be:


Without reading more,
you are either trolling, or
fucking retarded.

It does grow tiresome, Daniele.  Read the room a little bit.

On 9/7/23 14:30, Jan Stary wrote:

Without even reading ahead:
you are either trolling
or just fucking retarded.

(Is that a haiku?)


On Sep 07 16:27:18, my2...@has.im wrote:

Hello,

Just pushing myself over any device limit..
I just searched the App Stores for "Unix" and related ones
and wondering if we can hope to have an "OpenBSD Doc"
app beside a "FreeBSD Doc" app anytime soon?

Anyone's offer? Yes I'm talking to you.. ;D

-- Daniele Bonini






Re: "OpenBSD Doc" App idea

2023-09-08 Thread David Rinehart
After an issue with mangl, from ports, I discovered and configure man.cgi

on localhost httpd after install - works great (online or offline)!


Thanks,

David Rinehart


On 9/8/23 13:54, Amarendra Godbole wrote:
> On Fri, Sep 8, 2023 at 8:02 AM Luke Call  wrote:
>> On 2023-09-07 22:47:47+0200, Daniele B.  wrote:
 I don't know if Android has a similar feature, but at least on iOS you
 can save a particular website to your home as a webapp from Safari.
>>> Thanks for the answer Shokara. My initiative was to call for the development
>>> in the community of a serious app, with commands directory and full-text 
>>> search,
>>> working offline on multiple device with different screen orientation.
>>>
>>> Beside the possibility to create an home link of the online site on Android.
>>>
>> If you need full-text search from the desktop, this does the job for me.
>> I put it in my path and call the script "mank" since it resembles
>> Linux's "man -K" well enough
>> for me, and has been useful when I just know I read something but can't
>> remember where well enough to use apropos.  It is not fast.  It assumes
>> bash is installed from packages, but could easily be changed to use ksh 
>> instead.
>>
>> #!/usr/bin/env bash
>> set -eux
>> TMP=$(mktemp -t mank-tmp-output_XX)
>> nice grep -irE -C "$1" /usr/share/man/* 2>&1 > $TMP || true
>> nice grep -irE -C "$1" /usr/local/man/* 2>&1 >> $TMP || true
>> less -p "$1" $TMP
>> rm -f $TMP
>> echo $?
>>
>> I also have used wget a couple of times in the past to locally mirror
>> www.openbsd.org in case I needed something and can't get online, and
>> then one could grep that also (or use google to do a full-text online search
>> of that site), but I don't know whether that wget thing is a great idea.
> [...]
>
> Alternately, you can also clone the www repo: https://github.com/openbsd/www
>
> Thanks.
>
> -ag
>



Re: "OpenBSD Doc" App idea

2023-09-08 Thread Amarendra Godbole
On Fri, Sep 8, 2023 at 8:02 AM Luke Call  wrote:
>
> On 2023-09-07 22:47:47+0200, Daniele B.  wrote:
> >
> > > I don't know if Android has a similar feature, but at least on iOS you
> > > can save a particular website to your home as a webapp from Safari.
> >
> > Thanks for the answer Shokara. My initiative was to call for the development
> > in the community of a serious app, with commands directory and full-text 
> > search,
> > working offline on multiple device with different screen orientation.
> >
> > Beside the possibility to create an home link of the online site on Android.
> >
>
> If you need full-text search from the desktop, this does the job for me.
> I put it in my path and call the script "mank" since it resembles
> Linux's "man -K" well enough
> for me, and has been useful when I just know I read something but can't
> remember where well enough to use apropos.  It is not fast.  It assumes
> bash is installed from packages, but could easily be changed to use ksh 
> instead.
>
> #!/usr/bin/env bash
> set -eux
> TMP=$(mktemp -t mank-tmp-output_XX)
> nice grep -irE -C "$1" /usr/share/man/* 2>&1 > $TMP || true
> nice grep -irE -C "$1" /usr/local/man/* 2>&1 >> $TMP || true
> less -p "$1" $TMP
> rm -f $TMP
> echo $?
>
> I also have used wget a couple of times in the past to locally mirror
> www.openbsd.org in case I needed something and can't get online, and
> then one could grep that also (or use google to do a full-text online search
> of that site), but I don't know whether that wget thing is a great idea.
[...]

Alternately, you can also clone the www repo: https://github.com/openbsd/www

Thanks.

-ag



Re: "OpenBSD Doc" App idea

2023-09-08 Thread Luke Call
On 2023-09-07 22:47:47+0200, Daniele B.  wrote:
> 
> > I don't know if Android has a similar feature, but at least on iOS you
> > can save a particular website to your home as a webapp from Safari.
> 
> Thanks for the answer Shokara. My initiative was to call for the development
> in the community of a serious app, with commands directory and full-text 
> search,
> working offline on multiple device with different screen orientation.
> 
> Beside the possibility to create an home link of the online site on Android.
> 

If you need full-text search from the desktop, this does the job for me.
I put it in my path and call the script "mank" since it resembles 
Linux's "man -K" well enough
for me, and has been useful when I just know I read something but can't
remember where well enough to use apropos.  It is not fast.  It assumes
bash is installed from packages, but could easily be changed to use ksh instead.

#!/usr/bin/env bash
set -eux
TMP=$(mktemp -t mank-tmp-output_XX)
nice grep -irE -C "$1" /usr/share/man/* 2>&1 > $TMP || true
nice grep -irE -C "$1" /usr/local/man/* 2>&1 >> $TMP || true
less -p "$1" $TMP
rm -f $TMP
echo $?

I also have used wget a couple of times in the past to locally mirror
www.openbsd.org in case I needed something and can't get online, and
then one could grep that also (or use google to do a full-text online search
of that site), but I don't know whether that wget thing is a great idea.



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Sep 8, 2023 01:51:44 Shokara Kou :

> then I suggest reading Michael W. Lucas's book
> called Absolute OpenBSD[1] (and other books feature on OpenBSD's
> site[2]). Though it's not a mobile app, it's still an excellent source
> of documentation.

Hello, sorry for the nap ;D

Thank you for the suggestion Shokara. And no, book and app can't be
considered the same expecially in the full-text search feature and if you
want in the user appeal like the tailored solution of the app gives away. 

I think to have clarified all the the details of the app I'm minding that I hope
someone can develop before or after. I included also the screenshot.
And i added some candies on how for market reasons this and many other
public initiatives are not easy to happen when is about OpenBSD. Adding,
my 10$ a year to OpenBSD cause will surely not change that, unfortunately.

I'm pretty happy about all what the thread expressed.

Beside I support the suggestion to read Absolute OpenBSD book.

-- Daniele Bonini



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Shokara Kou
Hi again Daniele,

> I do not know if this is acceptable and forgive me for the unwanted
> advertisement but attached a screenshot of the basic functionalities of the 
> app
> I was wondering about.

If you want a good source of offline documentation for OpenBSD but don't
want to use an offline copy of man.openbsd.org (like the man set on a
regular OpenBSD install), then I suggest reading Michael W. Lucas's book
called Absolute OpenBSD[1] (and other books feature on OpenBSD's
site[2]). Though it's not a mobile app, it's still an excellent source
of documentation. A decent mobile PDF reader of your choice in addition
to an offline copy of the man pages used with Termux should be close to
what you're asking for?

You can also try adapting a Linux manpage app called Man Man[3] for use
with OpenBSD's man page too, but I don't see why you cannot just use the
previously mentioned options instead of going through the effort of
patching an Android program.

Regards,
Shokara

[1]: https://mwl.io/nonfiction/os#ao2e
[2]: https://www.openbsd.org/books.html
[3]: https://f-droid.org/packages/com.adonai.manman/



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Sep 7, 2023 23:39:46 Ingo Schwarze :

>> working offline
> 
> That's a pretty bad idea.  The information on man.openbsd.org
> is automatically updated every night; an offline copy would almost
> instantly become outdated

I'm pointing to a rich version of the FAQ more than the man, this
should have less frequent changes.

Hovewer, it is the main downside to solve. Being securely offline needs
to find the right approach to these updates.

-- Daniele Bonini



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Ingo Schwarze
Hi Daniele,

Daniele B. wrote on Thu, Sep 07, 2023 at 10:47:47PM +0200:

>> I don't know if Android has a similar feature, but at least on iOS you
>> can save a particular website to your home as a webapp from Safari.

> Thanks for the answer Shokara. My initiative was to call for the
> development in the community of a serious app, with commands directory

I'm not quite sure what you mean by "commands directory", but we
certainly provide a directory of commands:

  https://man.openbsd.org/?query=.=1=1

> and full-text search,

OpenBSD does not provide full-text search for its documentation
because full-text search is less powerful and more noisy than
the semantic search we do provide.  For details, see

  https://man.openbsd.org/man1/apropos.1
  https://man.openbsd.org/man.cgi.8

in particular

  https://man.openbsd.org/man1/apropos.1#Macro_Keys
  https://man.openbsd.org/man.cgi.8#HTML_search_interface

If you really want full-text search very badly, you can turn to NetBSD.
Last time i looked, they provided full-text search but not semantic
search.

On OpenBSD, you can of course use

   $ grep -R regexp /usr/share/man

but that will always spew lots of noise and only very rarely
any additional useful results in addition to what

   $ man -k any~regexp

provides.

> working offline

That's a pretty bad idea.  The information on man.openbsd.org
is automatically updated every night; an offline copy would almost
instantly become outdated.

Yours,
  Ingo



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.


> I don't know if Android has a similar feature, but at least on iOS you
> can save a particular website to your home as a webapp from Safari.

Thanks for the answer Shokara. My initiative was to call for the development
in the community of a serious app, with commands directory and full-text search,
working offline on multiple device with different screen orientation.

Beside the possibility to create an home link of the online site on Android.



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Thank you to touch base with the usual insults too, Jan. ;D

>> Windowz Doc, Mac Doc, Linux Doc and OpenBSD Doc App

I know how to discriminate and sort these apps obviously, it was an
humoristic axe I played against the non obvious coudardy to leave OpenBSD
always at the last place on the market for the joy of few but us.

I simply never would like to find myself in the urgent need of the doc
and see that online version could be quite "confusing" or sort of "incomplete
In some parts" caused by an "erroneus transmission".

Indeed I came from my search my App Store around Unix and found:
- FreeBSD Doc;
- Unix Tutorial;
- Linux command library;

And nothing about OpenBSD sporting neither its doc nor one marketing pin,
from here my initiative.




Re: "OpenBSD Doc" App idea

2023-09-07 Thread Shokara Kou
Hi Daniele,

> I was clearly meaning doing the doc app before to put the whole OpenBSD on 
> the cloud,
> sorry for the late clarification. ;D

I don't know if Android has a similar feature, but at least on iOS you
can save a particular website to your home as a webapp from Safari.
That way you can still have the up-to-date OpenBSD documentation from
man.openbsd.org in a pseudo-app.

Regards,
Shokara



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Jan Stary
On Sep 07 18:19:29, my2...@has.im wrote:
> Clearly I do not want to discriminate among
> Windowz Doc, Mac Doc, Linux Doc and OpenBSD Doc
> mobile apps, of the App Store ( the proposed order is clearly random)

Learn to discriminate, for everyone's sake.



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Jan Stary
Without even reading ahead:
you are either trolling
or just fucking retarded.

(Is that a haiku?)


On Sep 07 16:27:18, my2...@has.im wrote:
> Hello,
> 
> Just pushing myself over any device limit..
> I just searched the App Stores for "Unix" and related ones
> and wondering if we can hope to have an "OpenBSD Doc"
> app beside a "FreeBSD Doc" app anytime soon?
> 
> Anyone's offer? Yes I'm talking to you.. ;D
> 
> -- Daniele Bonini
> 
> 



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Sep 7, 2023 19:24:51 Ingo Schwarze :
> 
> In particular, there is no interest in providing an "OpenBSD Doc"
> app on Google Play, nor can i see any need for such an app.

I was clearly meaning doing the doc app before to put the whole OpenBSD on the 
cloud,
sorry for the late clarification. ;D
-- Daniele Bonini



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Ingo Schwarze
Hi Daniele,

Daniele B. wrote on Thu, Sep 07, 2023 at 06:08:06PM +0200:

> I simply opened my Google Play and I tried to search Unix
> and related terms, etc etc.

I had to look up what "Google Play" means, but now your question
is specific enough to allow an authoritative answer:

Providing apps to the "Google Play" app store falls outside the
scope of the OpenBSD project.

In particular, there is no interest in providing an "OpenBSD Doc"
app on Google Play, nor can i see any need for such an app.

To access OpenBSD docs on your Android device, simply use

  https://man.openbsd.org/

and report any adaptive design issues you might encounter.

Yours,
  Ingo

-- 
> Sorry to have awaked you,

I may have looked asleep, but i was merely writing documentation.  =:c)
#slackers



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Clearly I do not want to discriminate among
Windowz Doc, Mac Doc, Linux Doc and OpenBSD Doc
mobile apps, of the App Store ( the proposed order is clearly random)

-- Daniele Bonini



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Hey Ingo,

> I feel very confused

Sorry to have awaked you, I didn't think  "App Sore" could cause so much
disappointment in one person, sorry for that.
I notice that you oftwn write me sporting some .de domains, it will be a case I 
say.
I guess you are pointing about "my blood". However, no problem!

I simply opened my Google Play and I tried to search Unix and related terms, 
etc etc.
as mentiomed

> https://termux.dev/

Thank you very nide and off topic.

Appreciated, german one!


-- Daniele Bonini



Sep 7, 2023 17:46:49 Ingo Schwarze :

> In case you are talking about Android mobile devices - which,
> admittedly, is a wild guess on my part - the Termux system already
> includes the OpenBSD version of man(1) by default, and it has been
> doing so for more than a decade now.  In that sense, Android already
> has an OpenBSD documentation app.  For more information, see:
> 
>   https://termux.dev/
> 
> In case you are talking about Apple devices running macOS, newer
> versions of that system now also use the OpenBSD implementation as
> the formatting engine in their man(1) program - though last time i
> heard something about that, it didn't appear to be quite stable yet
> but hastily stitched together and rather buggy, as usual with Unix
> software on macOS in general.
> 
>> Anyone's offer? Yes I'm talking to you.. ;D
> 
> I feel very confused by your request, and i fear i don't really
> understand what you are asking for.



Re: "OpenBSD Doc" App idea

2023-09-07 Thread Ingo Schwarze
Hi Daniele,

Daniele B. wrote on Thu, Sep 07, 2023 at 04:27:18PM +0200:

> Just pushing myself over any device limit..

Huh?  What does that mean?

> I just searched the App Stores for "Unix" and related ones
> and wondering if we can hope to have an "OpenBSD Doc"
> app beside a "FreeBSD Doc" app anytime soon?

I'm usually interested in anything related to BSD documentation,
but it seems pretty unclear to me what you are talking about here.
What is the meaning of the term "app store"?

The "app store" for OpenBSD is documented in the manual pages pkg_add(1)
and packages(7), but you do not need any of that for reading OpenBSD
documentation nor for reading third-party documentation on OpenBSD.

The "app" you use on OpenBSD for reading documentation is standardized
by POSIX, called man(1), and on OpenBSD, it provides many extensions to
the standard.  Alternatively, at points in time when you do not have
access to any OpenBSD system, you can also read OpenBSD documentation
here, without needing any "app" whatsoever, in plain HTML5+CSS format:

  https://man.openbsd.org/

Now *if* you are talking about mobile devices, effort has been spent
on giving https://man.openbsd.org/ an adaptive design.  In case there
are still any respects in which it isn't mobile-friendly, reports
are quite welcome.  Again, no "app store" needed for all i know...

In case you are talking about Android mobile devices - which,
admittedly, is a wild guess on my part - the Termux system already
includes the OpenBSD version of man(1) by default, and it has been
doing so for more than a decade now.  In that sense, Android already
has an OpenBSD documentation app.  For more information, see:

  https://termux.dev/

In case you are talking about Apple devices running macOS, newer
versions of that system now also use the OpenBSD implementation as
the formatting engine in their man(1) program - though last time i
heard something about that, it didn't appear to be quite stable yet
but hastily stitched together and rather buggy, as usual with Unix
software on macOS in general.

> Anyone's offer? Yes I'm talking to you.. ;D

I feel very confused by your request, and i fear i don't really
understand what you are asking for.

Yours,
  Ingo



"OpenBSD Doc" App idea

2023-09-07 Thread Daniele B.
Hello,

Just pushing myself over any device limit..
I just searched the App Stores for "Unix" and related ones
and wondering if we can hope to have an "OpenBSD Doc"
app beside a "FreeBSD Doc" app anytime soon?

Anyone's offer? Yes I'm talking to you.. ;D

-- Daniele Bonini