7:46 a.m.
Please find here my feeling from a newcomer to connman.
First, it works. I have used it during months without having the idea to
try to read its doc. So, thank you for it !
But as I have IPV6 problems, so I try to find doc. My first try was to
find the README in jessie. This README is empty, so there is a problem
for the debian maintainer.
Next, google makes me go to https://01.org/connman/documentation which
sends me to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc that
I do not know how to read nor what it is speaking about.
and to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/src/main....
which is not usefull
I suggest the following small points which would have saved me hours :
in fact the main introduction is in
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
I suggest that :
1- a link to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
is added in https://01.org/connman/documentation
2- a README file containing a single line to link to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
is added in
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc
(Not all users are specialist git.kernel.org site or of git itself)
There is too a problem for debian maintainer : particularly where are
configuration file(s) ? I hope to find that in README.debian
I have tried to declare this as a documentation bug in
|https://01.org/jira/browse/CM|
But I am not allowed to connect.
PC
8:13 a.m.
Hi Patrik,
On 06/16/2017 09:46 AM, Pierre Couderc wrote:
Please find here my feeling from a newcomer to connman.
First, it works. I have used it during months without having the idea to
try to read its doc. So, thank you for it !
But as I have IPV6 problems, so I try to find doc. My first try was to
find the README in jessie. This README is empty, so there is a problem
for the debian maintainer.
Next, google makes me go to https://01.org/connman/documentation which
sends me to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc that
I do not know how to read nor what it is speaking about.
and to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/src/main....
which is not usefull
I suggest the following small points which would have saved me hours :
in fact the main introduction is in
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
I suggest that :
1- a link to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
is added in https://01.org/connman/documentation
2- a README file containing a single line to link to
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/README
is added in
https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc
Since I don't have access to 01.org can you adapt the website? I really
appreciate that Pierre takes the time to points out where we could
improve :)
(Not all users are specialist git.kernel.org site or of git itself)
There is too a problem for debian maintainer : particularly where are
configuration file(s) ? I hope to find that in README.debian
I have tried to declare this as a documentation bug in
|https://01.org/jira/browse/CM|
But I am not allowed to connect.
Again, I think Patrik might know how to get an account on this Jira.
Thanks,
Daniel
8:13 a.m.
Hi,
On Fri, 2017-06-30 at 10:13 +0200, Daniel Wagner wrote:
Hi Patrik,
On 06/16/2017 09:46 AM, Pierre Couderc wrote:
> Please find here my feeling from a newcomer to connman.
>
>
> First, it works. I have used it during months without having the
> idea to
> try to read its doc. So, thank you for it !
Thanks for the comments!
> But as I have IPV6 problems, so I try to find doc. My first try
was
> to
> find the README in jessie. This README is empty, so there is a
> problem
> for the debian maintainer.
That's a bit bad, and in addition the version has been lagging behind
from time to time. As ConnMan receives bug fixes with every rolling
release, using previous versions are never a good idea.
> Next, google makes me go to
https://01.org/connman/documentation
> which
> sends me to
>
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc
> that
> I do not know how to read nor what it is speaking about.
>
> and to
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/src
> /main.conf
> which is not usefull
>
>
> I suggest the following small points which would have saved me
> hours :
> in fact the main introduction is in
>
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/REA
> DME
>
> I suggest that :
>
> 1- a link to
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/REA
> DME
> is added in https://01.org/connman/documentation
Updated the first section of that page to contain links to the useful
resources in the following order: README, main.conf (for tuning),
config-format.txt (for pre-configured networks), vpn-config-format.txt
(for pre-configured VPNs) and the documentation directory on the git
server as the last option.
> 2- a README file containing a single line to link to
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/REA
> DME
>
> is added in
> https://git.kernel.org/pub/scm/network/connman/connman.git/tree/doc
>
All documentation except the 01.org page are found in the git sources
and the source code tar balls. So they should be covered.
Since I don't have access to 01.org can you adapt the website? I
really
appreciate that Pierre takes the time to points out where we could
improve :)
Done.
> (Not all users are specialist git.kernel.org site or of git
itself)
>
> There is too a problem for debian maintainer : particularly where
> are
> configuration file(s) ? I hope to find that in README.debian
>
> I have tried to declare this as a documentation bug in
> > https://01.org/jira/browse/CM|
>
> But I am not allowed to connect.
Interesting, it worked today, wonder if it had a temporary or more
permanent glitch?
Again, I think Patrik might know how to get an account on this Jira.
Good question. Anyone in the absence of JIRA downtime is/should be able
to see all bugs. Does this part work or what are the symptoms? After
that all I get is "Your JIRA administrator has not yet configured this
contact form.", so even I have to go for a bit of JIRA bug submission
contact hunting. But bugs are also welcomed on the mailing list.
HTH,
Patrik
1574
days inactive
1591
days old
2 comments
3 participants
participants (3)
-
Daniel Wagner -
Patrik Flykt -
Pierre Couderc