OpenSSL

2015-02-21 Thread Roland van Laar

Hello,

I want to contribute some fixes to the security/openssl page.
How would I go about doing that?
Specifically:
 - are there contribution guidelines
 - how should I contribute my fixes

Regards,

Roland

___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


[Bug 197685] Add switch between X and console to Handbook, Virtual Consoles

2015-02-21 Thread bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=197685

c.brinkh...@t-online.de changed:

   What|Removed |Added

 Attachment #153008|0   |1
is obsolete||
 CC||c.brinkh...@t-online.de

--- Comment #1 from c.brinkh...@t-online.de ---
Created attachment 153271
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=153271&action=edit
Add switch between X and Console in section 4.2.1 of the handbook

Two typos in first patch fixed.

-- 
You are receiving this mail because:
You are the assignee for the bug.
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


[Bug 197878] [patch][porters-handbook] update Xfce section

2015-02-21 Thread bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=197878

Bug ID: 197878
   Summary: [patch][porters-handbook] update Xfce section
   Product: Documentation
   Version: Latest
  Hardware: Any
OS: Any
Status: New
  Severity: Affects Only Me
  Priority: ---
 Component: Documentation
  Assignee: freebsd-doc@FreeBSD.org
  Reporter: olivi...@freebsd.org

Created attachment 153272
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=153272&action=edit
Patch to update the Xfce section

Update Xfce section following switch to USES= xfce [1].
The new framework will be used in the next stable release (4.12) planned for
the end of February.

[1] https://reviews.freebsd.org/D677

-- 
You are receiving this mail because:
You are the assignee for the bug.
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: OpenSSL

2015-02-21 Thread Allan Jude
On 2015-02-21 05:05, Roland van Laar wrote:
> Hello,
> 
> I want to contribute some fixes to the security/openssl page.
> How would I go about doing that?
> Specifically:
>  - are there contribution guidelines
>  - how should I contribute my fixes
> 
> Regards,
> 
> Roland
> 
> ___
> freebsd-doc@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

You can contribute them via bugzilla as either plain text and someone
else will do the markup for you, or as a patch against the docbook XML

The FreeBSD Documentation Project Primer:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/

Has details on the tools, process, and typographic conventions etc.


-- 
Allan Jude



signature.asc
Description: OpenPGP digital signature


igor and xmllint

2015-02-21 Thread Christoph Brinkhaus
Hello,

I have read the fdp-primer but I am not sure about
the verification of xml files.

In the quick start section igor is mentioned which
works well. Unfortunaltely I have overlooked it first
because it is just mentioned once.

In the other sections the files are checked by xmllint.
On by system I have problems with xmllint. Even the self
generated file a.txt can not be checked as below:

xmllint --valid --noout /home/chris/Projekte/a.txt 

The response is

/home/chris/Projekte/a.txt:2: validity error : Validation failed: no DTD found !
abc
 ^


Does igor included the functions of xmllint or not?
Is it necessary to verify a document ifirst by xmllint 
and then by igor? Or is the test using igor enough?

I am using FreeBSD for about one year. Therefore I am not
able to generate big documents which are valuable in terms
of the content.

I can help in changing docuemnts and by translating to German.

Kind regards,

Christoph
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: igor and xmllint

2015-02-21 Thread Allan Jude
On 2015-02-21 11:51, Christoph Brinkhaus wrote:
> Hello,
> 
> I have read the fdp-primer but I am not sure about
> the verification of xml files.
> 
> In the quick start section igor is mentioned which
> works well. Unfortunaltely I have overlooked it first
> because it is just mentioned once.
> 
> In the other sections the files are checked by xmllint.
> On by system I have problems with xmllint. Even the self
> generated file a.txt can not be checked as below:
> 
> xmllint --valid --noout /home/chris/Projekte/a.txt 
> 
> The response is
> 
> /home/chris/Projekte/a.txt:2: validity error : Validation failed: no DTD 
> found !
> abc
>  ^
> 
> 
> Does igor included the functions of xmllint or not?
> Is it necessary to verify a document ifirst by xmllint 
> and then by igor? Or is the test using igor enough?
> 
> I am using FreeBSD for about one year. Therefore I am not
> able to generate big documents which are valuable in terms
> of the content.
> 
> I can help in changing docuemnts and by translating to German.
> 
> Kind regards,
> 
> Christoph
> ___
> freebsd-doc@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
> 

igor is a perl script written by a FreeBSD Docs developer to catch
common mistakes. It looks to make you followed the conventions like two
spaces after a period, the correct indent level, catches common typos
and incorrect forms of works from the wordlist.

It is not the same as xmllint, which checks the validity of the xml.

XML documents require a DTD, which defines which elements are valid for
use in the document.

A typical article will look something like this:


http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd";>
http://docbook.org/ns/docbook";
  xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.0"
  xml:lang="en"> 

which allows all of the docbook elements to be used.

-- 
Allan Jude



signature.asc
Description: OpenPGP digital signature


Re: igor and xmllint

2015-02-21 Thread Christoph Brinkhaus
On Sat, Feb 21, 2015 at 12:27:52PM -0500, Allan Jude wrote:
> On 2015-02-21 11:51, Christoph Brinkhaus wrote:
> > Hello,
> > 
> > I have read the fdp-primer but I am not sure about
> > the verification of xml files.
> > 
> > In the quick start section igor is mentioned which
> > works well. Unfortunaltely I have overlooked it first
> > because it is just mentioned once.
> > 
> > In the other sections the files are checked by xmllint.
> > On by system I have problems with xmllint. Even the self
> > generated file a.txt can not be checked as below:
> > 
> > xmllint --valid --noout /home/chris/Projekte/a.txt 
> > 
> > The response is
> > 
> > /home/chris/Projekte/a.txt:2: validity error : Validation failed: no DTD 
> > found !
> > abc
> >  ^
> > 
> > 
> > Does igor included the functions of xmllint or not?
> > Is it necessary to verify a document ifirst by xmllint 
> > and then by igor? Or is the test using igor enough?
> > 
> > I am using FreeBSD for about one year. Therefore I am not
> > able to generate big documents which are valuable in terms
> > of the content.
> > 
> > I can help in changing docuemnts and by translating to German.
> > 
> > Kind regards,
> > 
> > Christoph
> > ___
> > freebsd-doc@freebsd.org mailing list
> > http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> > To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
> > 
> 
> igor is a perl script written by a FreeBSD Docs developer to catch
> common mistakes. It looks to make you followed the conventions like two
> spaces after a period, the correct indent level, catches common typos
> and incorrect forms of works from the wordlist.
> 
> It is not the same as xmllint, which checks the validity of the xml.
> 
> XML documents require a DTD, which defines which elements are valid for
> use in the document.
> 
> A typical article will look something like this:
> 
> 
>  Extension//EN"
> "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd";>
> http://docbook.org/ns/docbook";
>   xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.0"
>   xml:lang="en"> 
> 
> which allows all of the docbook elements to be used.
> 
> -- 
> Allan Jude
> 
Dear Allan,

thank you for the quick answer.
I have a problem verifying existing xml files as

/usr/doc/en_US.ISO8859-1/books/handbook # xmllint --valid --noout book.xml 
book.xml:14: warning: failed to load external entity 
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd";
]>
  ^
book.xml:18: element book: validity error : No declaration for attribute xmlns 
of element book
  xml:lang="en">
   ^
book.xml:18: element book: validity error : No declaration for attribute 
xmlns:xlink of element book
  xml:lang="en">
   ^
and so on. From my understanding the catalog files in /usr/doc/share/xml/
should handle that. I will dig the correct command line parameter.

Kind regards,

Christoph
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"