Skip to content

L
libvirt

openeuler / libvirt

通知 3
Star 0
Fork 0
L
libvirt
切换分支/标签
  1. 22 11月, 2019 1 次提交
  3. 28 8月, 2019 1 次提交
  5. 16 8月, 2019 1 次提交
  7. 31 1月, 2019 1 次提交
    • P
      docs: Format bit shift and hex notation for bitwise flag enums · 63cbad4e
      由 Peter Krempa 提交于 
      Big number itself does not make much sense in some cases. Format the
bitshift format as well.

Changes our web page docs from:

VIR_MIGRATE_POSTCOPY = 32768 : Setting the VIR_MIGRATE_POSTCOPY...
VIR_MIGRATE_TLS      = 65536 : Setting the VIR_MIGRATE_TLS flag...

to:

VIR_MIGRATE_POSTCOPY = 32768 (0x8000; 1 << 15)  : Setting the VIR_MIGRATE_POSTCOPY...
VIR_MIGRATE_TLS      = 65536 (0x10000; 1 << 16) : Setting the VIR_MIGRATE_TLS flag...
Signed-off-by: NPeter Krempa <pkrempa@redhat.com>
      63cbad4e
  9. 03 8月, 2017 2 次提交
  11. 26 7月, 2017 1 次提交
  13. 24 7月, 2017 1 次提交
    • M
      docs: Span cells if there's not doc text for enum val · 099a5ef8
      由 Michal Privoznik 提交于 
      When generating HTML documentation we put enum values into a
table so that we can display the value's name, numerical value
and description (if it has one). Now the last part is problem. If
the value doesn't have description the table row has just two
cells and if it has one the row counts three cells. This makes
HTML engines render the description into very little space - for
instance see:

  html/libvirt-libvirt-domain.html#virDomainMemoryStatTags

We can avoid this problem if we let the cell that corresponds to
numerical value span over two cells if there's no description.
Signed-off-by: NMichal Privoznik <mprivozn@redhat.com>
Reviewed-by: NMartin Kletzander <mkletzan@redhat.com>
      099a5ef8
  15. 31 10月, 2013 3 次提交
  17. 23 9月, 2013 1 次提交
  19. 10 8月, 2013 1 次提交
    • D
      Add documentation for access control system · da13f2c7
      由 Daniel P. Berrange 提交于 
      This adds two new pages to the website, acl.html describing
the general access control framework and permissions models,
and aclpolkit.html describing the use of polkit as an
access control driver.

page.xsl is modified to support a new syntax

  <div id="include" filename="somefile.htmlinc"/>

which will cause the XSL transform to replace that <div>
with the contents of 'somefile.htmlinc'. We use this in
the acl.html.in file, to pull the table of permissions
for each libvirt object. This table is autogenerated
from the enums in src/access/viraccessperms.h by the
genaclperms.pl script.

newapi.xsl is modified so that the list of permissions
checks shown against each API will link to the description
of the permissions in acl.html
Signed-off-by: NDaniel P. Berrange <berrange@redhat.com>
      da13f2c7
  21. 08 8月, 2013 1 次提交
    • D
      Add info about access control checks into API reference · 664ab280
      由 Daniel P. Berrange 提交于 
      So that app developers / admins know what access control checks
are performed for each API, this patch extends the API docs
generator to include details of the ACLs for each.

The gendispatch.pl script is extended so that it generates
a simple XML describing ACL rules, eg.

  <aclinfo>
    ...
    <api name='virConnectNumOfDomains'>
      <check object='connect' perm='search_domains'/>
      <filter object='domain' perm='getattr'/>
    </api>
    <api name='virDomainAttachDeviceFlags'>
      <check object='domain' perm='write'/>
      <check object='domain' perm='save' flags='!VIR_DOMAIN_AFFECT_CONFIG|VIR_DOMAIN_AFFECT_LIVE'/>
      <check object='domain' perm='save' flags='VIR_DOMAIN_AFFECT_CONFIG'/>
    </api>
    ...
  </aclinfo>

The newapi.xsl template loads the XML files containing the ACL
rules and generates a short block of HTML for each API describing
the parameter checks and return value filters (if any).
Signed-off-by: NDaniel P. Berrange <berrange@redhat.com>
      664ab280
  23. 07 5月, 2013 1 次提交
  25. 01 2月, 2013 1 次提交
  27. 18 1月, 2013 2 次提交
    • C
      docs: don't use <i> and <tt> HTML tags · cb022b6b
      由 Claudio Bley 提交于 
      Use of <tt> is discouraged in HTML 4.x and has finally been obsoleted
in HTML 5. Likewise for the <i> tag.

Using tables for layout is (widely) considered bad style, too.

Use defintion lists, definition term and defintion description
elements instead.
Signed-off-by: NClaudio Bley <cbley@av-test.de>
      cb022b6b
    • C
      docs: Assign classes to documentation elements · 458dd20d
      由 Claudio Bley 提交于 
      In CSS the following class names are available:

* keyword     (keywords like "typedef", "struct")
* type        (types like "int", "void*")
* comment     (comments after members of enums or structs)
* directive   (preprocessor directives, #define)
* undisclosed (text saying that the API is not public)

Additionally, kill all of the left-over "programlisting" class
assignments. There are no CSS rules for them.
Signed-off-by: NClaudio Bley <cbley@av-test.de>
      458dd20d
  29. 09 1月, 2013 1 次提交
    • C
      docs: break longer text into paragraphs in HTML · 3b54b2e3
      由 Claudio Bley 提交于 
      Libvirt's HTML documentation is not as easy to the eyes as it could
be since long text has no visual breaks.

Take advantage of the formatting in documentation comments and wrap
each part separated by two consecutive \n into a HTML <p> element.
      3b54b2e3
  31. 12 8月, 2011 1 次提交
    • P
      Improve tokenizing of linkable terms · ce7244a0
      由 Philipp Hahn 提交于 
      Currently only tabs and blanks are used for tokenizing the description,
which breaks when a term is at the end of a line or has () appended to
it.
1. Use also other white space characters such as new-lines and carriage
   return for splitting.
2. Remove some common non-word characters from the token before lookup.
Signed-off-by: NPhilipp Hahn <hahn@univention.de>
      ce7244a0
  33. 22 6月, 2011 1 次提交
    • D
      Fix to python API extractor and API doc generation · d42ea21a
      由 Daniel Veillard 提交于 
      This fixes a number of issues most of them raised by Eric Blake on the
generated documentation output:
   - parsing of "long long int" and similar
   - add parsing of unions within a struct
   - remove spurious " * " fron comments on structure fields and enums
   - fix concatenation of base type and name in arrays
   - extend XSLT to cope with union in structs

* docs/apibuild.py: fix and extend API extraction tool
* docs/newapi.xsl: extend the stylesheets to cope with union in
  public structures
      d42ea21a
  35. 08 12月, 2009 1 次提交
  37. 26 4月, 2008 1 次提交
  39. 24 4月, 2008 1 次提交
  41. 06 2月, 2008 1 次提交
  43. 29 6月, 2007 1 次提交
  45. 10 2月, 2006 1 次提交
  47. 22 1月, 2006 1 次提交
  49. 20 1月, 2006 1 次提交
  51. 09 12月, 2005 2 次提交
  53. 07 12月, 2005 1 次提交