[kde-doc-english] Review Request 114742: Add KBibTeX documentation

T.C. Hollingsworth tchollingsworth at gmail.com
Mon Dec 30 19:15:40 UTC 2013


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/114742/#review46454
-----------------------------------------------------------


Looks really good, just a few grammar nits.

You might have convinced me to use something better than LibreOffice + Zotero.  ;-)


doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33121>

    Don't these two paragraphs basically say the same thing?  :-)



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33122>

    Please stick with one tense here at the end.  (e.g. either "completion, compilation" or "completing, compiling") It reads awkwardly when you mix the two.



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33123>

    editors -> editor



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33124>

    Enter preamble -> Enter a preamble



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33125>

    Choose entry encoding -> Choose an entry encoding



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33126>

    missing a "using" between the description and the first <menuchoice> like the others in the list



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33127>

    window looking similar -> window that looks similar



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33128>

    choose -> choose the



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33129>

    from &kbibtex; menu -> from the &kbibtex; menu



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33130>

    for the referencing of the bibliography entry -> for referencing the bibliography entry



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33131>

    Using of the -> Using the



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33132>

    ABC order -> alphabetic order



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33133>

    maybe explain what are entry labels? (complete LaTeX noob here :-)



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33134>

    &latex; editor capabilities -> &latex; editor's capabilities



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33135>

    see the results, &DVI; -> see the results as a &DVI;



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33136>

    using <menuchoice> -> using the <menuchoice>



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33137>

    using <link -> using the <link



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33149>

    current selected -> currently selected
    
    Since there are a few of these, I guess I should mention, this is only wrong in the few areas I point out because you need the "-ly" when "current" describes a verb, as in "currently selected" or when it describes another adjective, as in "currently active".  Many of the "current"s in this doc describe a noun, like "current bibliography", which is correct.  (Ugh, English.  :-p)



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33139>

    is lowercasing -> will lowercase



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33140>

    perform search -> perform a search



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33148>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33141>

    perform search -> perform a search



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33142>

    visit database homepage -> visit the database homepage



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33150>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33151>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33152>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33153>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33146>

    the toolbars customization -> customizing the toolbars



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33147>

    creates new -> creates a new



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33154>

    current active -> currently active



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33155>

    current active -> currently active



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33156>

    current open -> currently open



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33157>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33158>

    in the large -> in large



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33159>

    current opened -> currently opened



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33160>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33161>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33162>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33163>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33164>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33165>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33166>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33167>

    via Preferences dialog -> via the Preferences dialog



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33168>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33169>

    Color labels is -> Color labels are



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33170>

    current selected -> currently selected



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33171>

    identifiers suggestion schemes -> identifier suggestion schemes



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33172>

    make &kbibtex; to show -> make &kbibtex; show



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33173>

    click on -> click on the



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33174>

    Click on Apply button -> Click on the Apply button



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33175>

    on -> on the



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33176>

    use <guimenuitem -> use the <guimenuitem



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33177>

    from &lyx; main menu -> from the &lyx; main menu



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33178>

    there you want -> where you want



doc/index.docbook
<https://git.reviewboard.kde.org/r/114742/#comment33179>

    use a package manager -> use the package manager


- T.C. Hollingsworth


On Dec. 30, 2013, 6:01 p.m., Yuri Chornoivan wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/114742/
> -----------------------------------------------------------
> 
> (Updated Dec. 30, 2013, 6:01 p.m.)
> 
> 
> Review request for Documentation and Thomas Fischer.
> 
> 
> Repository: kbibtex
> 
> 
> Description
> -------
> 
> A brief documentation including man page (converted from previous untranslatable version).
> 
> 
> Diffs
> -----
> 
>   doc/new-document.png PRE-CREATION 
>   doc/online-search.png PRE-CREATION 
>   doc/reference-preview.png PRE-CREATION 
>   doc/search-results.png PRE-CREATION 
>   doc/statistics.png PRE-CREATION 
>   doc/svn-update.png PRE-CREATION 
>   doc/tools-check-spelling.png PRE-CREATION 
>   doc/view-filter.png PRE-CREATION 
>   man/CMakeLists.txt 3c5b808 
>   man/kbibtex.1 ce67b21 
>   doc/list-remove.png PRE-CREATION 
>   doc/lyx-preferences.png PRE-CREATION 
>   doc/main-toolbar.png PRE-CREATION 
>   doc/man-kbibtex.1.docbook PRE-CREATION 
>   doc/media-playback-start.png PRE-CREATION 
>   doc/CMakeLists.txt PRE-CREATION 
>   doc/add-macro-source.png PRE-CREATION 
>   doc/add-macro.png PRE-CREATION 
>   doc/application-pdf.png PRE-CREATION 
>   doc/applications-internet.png PRE-CREATION 
>   doc/code-context.png PRE-CREATION 
>   doc/config-color.png PRE-CREATION 
>   doc/config-general.png PRE-CREATION 
>   doc/config-id-suggestions.png PRE-CREATION 
>   doc/config-keywords.png PRE-CREATION 
>   doc/config-pdf.png PRE-CREATION 
>   doc/config-saving.png PRE-CREATION 
>   doc/config-user-interface.png PRE-CREATION 
>   doc/configure.png PRE-CREATION 
>   doc/cross-ref.png PRE-CREATION 
>   doc/document-open-remote.png PRE-CREATION 
>   doc/document-open.png PRE-CREATION 
>   doc/document-preview.png PRE-CREATION 
>   doc/document-revert.png PRE-CREATION 
>   doc/document-save.png PRE-CREATION 
>   doc/draw-text.png PRE-CREATION 
>   doc/edit-clear-locationbar-rtl.png PRE-CREATION 
>   doc/edit-element.png PRE-CREATION 
>   doc/edit-undo.png PRE-CREATION 
>   doc/element-editor.png PRE-CREATION 
>   doc/external-tab.png PRE-CREATION 
>   doc/favorites.png PRE-CREATION 
>   doc/file-settings.png PRE-CREATION 
>   doc/filter-toolbar.png PRE-CREATION 
>   doc/find-pdf.png PRE-CREATION 
>   doc/first-run.png PRE-CREATION 
>   doc/flag.png PRE-CREATION 
>   doc/go-down.png PRE-CREATION 
>   doc/go-up.png PRE-CREATION 
>   doc/index.docbook PRE-CREATION 
>   doc/list-add.png PRE-CREATION 
>   doc/list-of-documents.png PRE-CREATION 
>   doc/list-of-values.png PRE-CREATION 
>   CMakeLists.txt 194ba74 
> 
> Diff: https://git.reviewboard.kde.org/r/114742/diff/
> 
> 
> Testing
> -------
> 
> EBN, checkXML, compilation, installation. Thomas Fischer did not object to the general concept of the manual when discussing it via email.
> 
> PDF version to ease up reviewing is available here:
> 
> https://dl.dropboxusercontent.com/u/55247264/kbibtex.pdf
> 
> 
> Thanks,
> 
> Yuri Chornoivan
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20131230/269e0fdb/attachment-0001.html>


More information about the kde-doc-english mailing list