On 20 March 2013 19:44, Steve Marquess marqu...@opensslfoundation.com wrote:
There are tools of a sort to convert between docbook, pod, and markdown.
I've played with a couple of them, but I think annoying little details
will keep such tools from representing any net labor savings over manual
On 03/19/2013 07:49 PM, Pierre DELAAGE wrote:
Hi Steve,
My own experience in my company is that OpenOffice is perfectly suited
for track changes in a collaborative env.
Ok, allright, it cannot offer a line by line diff as in cvs systems, and
return to specific version and so on, but the track
On 19 March 2013 18:53, Steve Marquess marqu...@opensslfoundation.com wrote:
On 03/19/2013 10:47 AM, Pierre DELAAGE wrote:
Dear Steve, I was wondering whether the wiki could be fed at the
beginning by all the Documents available at
http://www.openssl.org/docs/;.
Very often people are able to
On 19 March 2013 23:27, Steve Marquess marqu...@opensslfoundation.com wrote:
On 03/19/2013 04:59 PM, Matt Caswell wrote:
On 19 March 2013 19:38, Steve Marquess marqu...@opensslfoundation.com
wrote:
I took a quick look to see what utilities might be available to convert
between pod and
On 03/19/2013 03:15 PM, Ben Laurie wrote:
...
Very often people are able to comment, eg, a command page with some
samples or error comments, instead of rewriting from scratch a man
page.
And this could be a way to only have one unique set of docs to
maintain, and to refer to, instead of
With some trepidation, and considerable assistance from a small group of
earlier adopters, I hereby unleash a new OpenSSL Wiki on an unsuspecting
world:
http://wiki.opensslfoundation.com/
There is a need for more and better OpenSSL documentation, and the
hopeful theory here is that this Wiki
http://wiki.opensslfoundation.com/
Great. It would be good to have a link pointing to this on the documents tab
on openssl.org
--
Principal Security Engineer
Akamai Technology
Cambridge, MA
__
OpenSSL Project
assistance from a small group of
earlier adopters, I hereby unleash a new OpenSSL Wiki on an unsuspecting
world:
http://wiki.opensslfoundation.com/
There is a need for more and better OpenSSL documentation, and the
hopeful theory here is that this Wiki will serve as a focal point
On 03/19/2013 10:47 AM, Pierre DELAAGE wrote:
Dear Steve, I was wondering whether the wiki could be fed at the
beginning by all the Documents available at
http://www.openssl.org/docs/;.
Very often people are able to comment, eg, a command page with some
samples or error comments, instead
Dear Ben and Steve,
I think that once the wiki is at least fed by the docs,
the docs space should link directly to the wiki,
to avoid duplication...
The purpose of the wiki is to get more people involved in the doc,
and hopefully to get a more up-to-date doc,
and I would say : to prevent experts
On 03/19/2013 10:47 AM, Pierre DELAAGE wrote:
Dear Steve,
I was wondering whether the wiki could be fed at the beginning by all
the Documents available at http://www.openssl.org/docs/;.
Very often people are able to comment, eg, a command page with some
samples or error comments,
instead
Dear Steve,
I am pleased you found something useful in my comments.
Just to mention :
Yes I suggest something like you said ...three major divisions:
reference, programming, and
didactic..
I would just add : programming/...using, I am thinking about the
command line tools...
although, as they
Dear Ben and Steve,
I think that once the wiki is at least fed by the docs,
the docs space should link directly to the wiki,
to avoid duplication...
The purpose of the wiki is to get more people involved in the doc,
and hopefully to get a more up-to-date doc,
and I would say : to prevent experts
hmm, Steve I highly suggest that we have a look at ...OpenOffice and its
various export filters.
for mediawiki it is there :
http://extensions.services.openoffice.org/fr/node/738
for Docbook the filter is embedded (never tested by myself..).
Does it help ?
Pierre
Le 19/03/2013 20:38, Steve
On 19 March 2013 19:38, Steve Marquess marqu...@opensslfoundation.com wrote:
I took a quick look to see what utilities might be available to convert
between pod and mediawiki markup formats. pod2markdown (CPAN) is close
but not quite there.
The pod markup language is pretty basic. If something
On Tue, 19 Mar 2013, Matt Caswell wrote:
Alternatively we just ditch pod altogether - but that would
lose the ability to create man pages (does anyone still read man
pages)?
Yes, some of us still do.
--
Tim RiceMultitalents
t...@multitalents.net
On 03/19/2013 04:04 PM, Pierre DELAAGE wrote:
hmm, Steve I highly suggest that we have a look at ...OpenOffice and its
various export filters.
for mediawiki it is there :
http://extensions.services.openoffice.org/fr/node/738
for Docbook the filter is embedded (never tested by myself..).
On 03/19/2013 04:59 PM, Matt Caswell wrote:
On 19 March 2013 19:38, Steve Marquess marqu...@opensslfoundation.com wrote:
I took a quick look to see what utilities might be available to convert
between pod and mediawiki markup formats. pod2markdown (CPAN) is close
but not quite there.
The
Hi Steve,
My own experience in my company is that OpenOffice is perfectly suited
for track changes in a collaborative env.
Ok, allright, it cannot offer a line by line diff as in cvs systems, and
return to specific version and so on, but the track changes can help.
In my company, we were
:o*@nn-idol*::D
-Original Message-
From: Pierre DELAAGE
Sent: 3/19/2013 11:49:24 PM
To: openssl-dev@openssl.org
Cc: Steve Marquess
Subject: Re: OpenSSL Wiki (docbook and...)
Hi Steve,
My own experience in my company is that OpenOffice is perfectly suited
for track changes
:o*@nn-idol*::D
-Original Message-
From: Pierre DELAAGE
Sent: 3/19/2013 11:49:24 PM
To: openssl-dev@openssl.org
Cc: Steve Marquess
Subject: Re: OpenSSL Wiki (docbook and...)
Hi Steve,
My own experience in my company is that OpenOffice is perfectly suited
for track changes
21 matches
Mail list logo