summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAllen Winter <allen.winter@kdab.com>2022-06-02 18:05:46 -0400
committerAllen Winter <allen.winter@kdab.com>2022-06-02 18:05:46 -0400
commit50803785ec67e0ad59248841ffd981332127ee39 (patch)
treed580a34c62ea55032fee5be156f288c4813ac4c3
parent61536a88acc5f93a4ba1fbc284f174c5f6b687c3 (diff)
parent6166e2ffd1decdeeaa080586e91f4843991d3ba2 (diff)
downloadlibical-git-50803785ec67e0ad59248841ffd981332127ee39.tar.gz
Merge branch '3.0'
-rw-r--r--.mdlrc1
-rw-r--r--.mdlrc.rb4
-rw-r--r--.pre-commit-config.yaml18
-rw-r--r--README.md16
-rw-r--r--doc/UsingLibical.md231
5 files changed, 140 insertions, 130 deletions
diff --git a/.mdlrc b/.mdlrc
new file mode 100644
index 00000000..3acbfeca
--- /dev/null
+++ b/.mdlrc
@@ -0,0 +1 @@
+style ".mdlrc.rb"
diff --git a/.mdlrc.rb b/.mdlrc.rb
new file mode 100644
index 00000000..406f45b3
--- /dev/null
+++ b/.mdlrc.rb
@@ -0,0 +1,4 @@
+all
+rule 'MD013', :line_length => 100
+rule 'MD029', :style => :ordered
+exclude_rule 'MD033'
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index afb1a3a8..740fde24 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -22,9 +22,15 @@ repos:
rev: v2.1.0
hooks:
- id: codespell
-repos:
- - repo: https://github.com/cheshirekow/cmake-format-precommit
- rev: v0.6.13
- hooks:
- - id: cmake-lint
- exclude: cmake/Toolchain-*
+- repo: https://github.com/cheshirekow/cmake-format-precommit
+ rev: v0.6.13
+ hooks:
+ - id: cmake-lint
+ exclude: cmake/Toolchain-*
+- repo: https://github.com/markdownlint/markdownlint
+ rev: v0.11.0
+ hooks:
+ - id: markdownlint
+ entry: mdl
+ language: ruby
+ files: \.(md|mdown|markdown)$
diff --git a/README.md b/README.md
index af3708f1..49a67fe2 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
# Libical
-[![Appveyor status](https://ci.appveyor.com/api/projects/status/github/libical/libical?branch=master?svg=true)](https://ci.appveyor.com/api/projects/status/github/libical/libical) [![Packaging status](https://repology.org/badge/tiny-repos/libical.svg)](https://repology.org/metapackage/libical)
+[![Appveyor status](https://ci.appveyor.com/api/projects/status/github/libical/libical?branch=master?svg=true)](https://ci.appveyor.com/api/projects/status/github/libical/libical)
+[![Packaging status](https://repology.org/badge/tiny-repos/libical.svg)](https://repology.org/metapackage/libical)
## Introduction
@@ -9,7 +10,7 @@ Libical — an implementation of iCalendar protocols and data formats
Most of the code in here was written by Eric Busboom at the end
of the last millennium with help from dozens of contributors.
It is currently maintained by Allen Winter and the libical team
-at https://github.com/libical/libical.
+at <https://github.com/libical/libical>.
Libical is an Open Source implementation of the iCalendar protocols
and protocol data units. The iCalendar specification describes how
@@ -78,18 +79,17 @@ In no particular order:
* [Cyrus Email/Calendars/Contacts Server](https://www.cyrusimap.org)
* [syncEvolution](https://syncevolution.org)
* [Fantastical](https://flexibits.com/fantastical)
-
* GNOME's EDS (evolution-data-server) which serves data to:
* [Evolution](https://wiki.gnome.org/Apps/Evolution)
* [GNOME Calendar](https://wiki.gnome.org/Apps/Calendar)
* [GNOME Notes](https://wiki.gnome.org/Apps/Notes)
* [GNOME Todo](https://wiki.gnome.org/Apps/Todo)
* and more GNOME apps...
-
- * KDE's [Kontact Suite](https://kontact.kde.org)
- * [Akonadi framework](https://kontact.kde.org/components/akonadi.html)
- * [KOrganizer calendar and scheduling component](https://kontact.kde.org/components/korganizer.html)
- * and more KDE apps...
+* KDE:
+ * [Kontact](https://kontact.kde.org):
+ * [Akonadi framework](https://kontact.kde.org/components/akonadi.html)
+ * [KOrganizer calendar and scheduling component](https://kontact.kde.org/components/korganizer.html)
+ * and more KDE apps...
## Get Involved
diff --git a/doc/UsingLibical.md b/doc/UsingLibical.md
index abd297ca..de3dda59 100644
--- a/doc/UsingLibical.md
+++ b/doc/UsingLibical.md
@@ -1,8 +1,8 @@
# Using Libical {#UsingLibical}
-> Author: Eric Busboom <eric@civicknowledge.com>
->
-> Date: January 2001
+> Author: Eric Busboom <eric@civicknowledge.com>
+>
+> Date: January 2001
## 1 Introduction
@@ -16,7 +16,6 @@ the CalDav scheduling extensions in [RFC6638][];
the iCalendar extensions in [RFC7986][], [RFC9073][], [RFC9074][];
and some of [RFC6047][].
-
This documentation assumes that you are familiar with the iCalendar
standards RFC5545 and RFC5546. These specifications are available
at the [IETF Tools][] website:
@@ -161,7 +160,7 @@ or union.
#### 3.2.2 The parser
-The libical parser offers a variety of ways to convert [RFC5545][] text
+The libical parser offers a variety of ways to convert [RFC5545][] text
into a libical internal component structure. The parser can parse
blocks of text as a string, or it can parse line-by-line.
@@ -174,7 +173,7 @@ errors and component usage errors.
Since many of libical's interfaces return strings, the library has its
own memory management system to eliminate the need to free every string
-returned from the library.
+returned from the library. See [Memory Management](#memory).
#### 3.2.5 Storage classes
@@ -195,7 +194,7 @@ by maintaining a self-similar interface.
Libical defines components for groups of properties that look and act
like components, but are not defined as components in the specification.
`XDAYLIGHT` and `XSTANDARD` are notable examples. These pseudo components
-group properties within the `VTIMEZONE` components. For instanace, the
+group properties within the `VTIMEZONE` components. For instance, the
timezone properties associated with daylight savings time starts with
`BEGIN:DAYLIGHT` and ends with `END:DAYLIGHT`, just like other components,
but is not defined as a component in [RFC5545][] (see [section 3.6.5][RFC5545 3.6.5])
@@ -230,7 +229,7 @@ It is natural to have interfaces that would return the value of a property,
but it is cumbersome for a single routine to return multiple types.
So, in libical, properties that can have multiple types are given
a single type that is the union of their RFC5545 types. For instance,
-in libical, the value of the `TRIGGER` property resolves to struct
+in libical, the value of the `TRIGGER` property resolves to struct
`icaltriggertype`. This type is a union of a `DURATION` and a `DATE-TIME`.
### 4.3 Multi-Valued Properties
@@ -266,10 +265,11 @@ into one.
### 5.1 Creating Components
-There are three ways to create components in Libical:
-1. creating individual objects and assembling them,
-2. building entire objects in massive vaargs calls,
-3. and parsing a text file containing iCalendar data.
+There are three ways to create components in Libical:
+
+1. creating individual objects and assembling them,
+2. building entire objects in massive vargs calls,
+3. parsing a text file containing iCalendar data.
#### 5.1.1 Constructor Interfaces
@@ -305,7 +305,7 @@ Most things you work with are objects, that are instantiated with
a constructor that has "new" in the name. Also note that, other than
the object reference, most structure data is passed in to libical
routines by value. Libical has some complex but very regular memory
-handling rules. These are detailed in section [sec:memory].
+handling rules. These are detailed in section [Memory Management](#memory).
If any of the constructors fail, they will return 0. If you try to
insert 0 into a property or component, or use a zero-valued object
@@ -354,9 +354,9 @@ calendar =
This form is similar to the constructor form, except that the constructors
have `vanew` instead of `new` in the name. The arguments are similar
too, except that the component constructor can have a list of properties,
-and the property constructor can have a list of parameters.
+and the property constructor can have a list of parameters.
-*Be sure to terminate every list with a `NULL` (or a *`(void 0)`*, or your code
+*Be sure to terminate every list with a `NULL` (or a *`(void 0)`*, or your code
will crash, if you are lucky*. The reason you can't use 0 itself is that
depending on what platform you are on, `sizeof(int) ≠ sizeof(void*)`.
@@ -372,7 +372,7 @@ icalcomponent* icalparser_parse_string(char* str);
If the string contains only one component, the parser will return the
component in libical form. If the string contains multiple components,
-the multiple components will be returned as the children of an
+the multiple components will be returned as the children of an
`ICAL_XROOT_COMPONENT` component.
Parsing a whole string may seem wasteful if you want to pull a large
@@ -409,7 +409,7 @@ char* read_stream(char *s, size_t size, void *d)
return fgets(s, size, (FILE*)d);
}
-int main(int argc, char *argv[])
+int main(int argc, char *argv[])
{
char *line;
icalcomponent *component;
@@ -479,7 +479,7 @@ char* read_stream(char *s, size_t size, void *d)
return fgets(s, size, (FILE*)d);
}
-int main(int argc, char *argv[])
+int main(int argc, char *argv[])
{
char* line;
icalcomponent *component;
@@ -527,13 +527,13 @@ icalcomponent* icalcomponent_get_first_component(
This routine will return a reference to the first component of the
type `kind`. The key kind values, listed in icalenums.h are:
-- `ICAL_ANY_COMPONENT`
-- `ICAL_VEVENT_COMPONENT`
-- `ICAL_VTODO_COMPONENT`
-- `ICAL_VJOURNAL_COMPONENT`
-- `ICAL_VCALENDAR_COMPONENT`
-- `ICAL_VFREEBUSY_COMPONENT`
-- `ICAL_VALARM_COMPONENT`
+- `ICAL_ANY_COMPONENT`
+- `ICAL_VEVENT_COMPONENT`
+- `ICAL_VTODO_COMPONENT`
+- `ICAL_VJOURNAL_COMPONENT`
+- `ICAL_VCALENDAR_COMPONENT`
+- `ICAL_VFREEBUSY_COMPONENT`
+- `ICAL_VALARM_COMPONENT`
These are only the most common components; there are many more listed
in icalenums.h.
@@ -618,7 +618,7 @@ Here is an example of a loop using these routines:
```c
for(i = icalcomponent_begin_component(impl->cluster, ICAL_ANY_COMPONENT);
icalcompiter_deref(&i)!= 0;
- icalcompiter_next(&i))
+ icalcompiter_next(&i))
{
icalcomponent *this = icalcompiter_deref(&i);
}
@@ -645,7 +645,7 @@ for(c = icalcomponent_get_first_component(parent_comp, ICAL_ANY_COMPONENT);
}
```
-Another way to remove components is to rely on the side effect of
+Another way to remove components is to rely on the side effect of
`icalcomponent_remove_component()`:
if component iterator in the parent component is pointing to the child
that will be removed, it will move the iterator to the component after
@@ -721,13 +721,13 @@ the properties that contain them. This involves fewer routine calls
and intermediate variables than working with them independently, and
it is type-safe.
-For each property, there are a `_get_()` and a `_set_()` routine that
-accesses the internal value. For instanace, for the `UID` property, the
+For each property, there are a `_get_()` and a `_set_()` routine that
+accesses the internal value. For instanace, for the `UID` property, the
routines are:
```c
void icalproperty_set_uid(
- icalproperty* prop,
+ icalproperty* prop,
const char* v);
const char* icalproperty_get_uid(
@@ -745,7 +745,7 @@ icalvalue* icalproperty_get_value(
icalproperty* prop);
void icalproperty_set_value(
- icalproperty* prop,
+ icalproperty* prop,
icalvalue* value);
```
@@ -759,7 +759,7 @@ struct icaltimetype icalvalue_get_datetime(
icalvalue* value);
void icalvalue_set_datetime(
- icalvalue* value,
+ icalvalue* value,
struct icaltimetype v);
```
@@ -769,7 +769,7 @@ always a string. To get and set the value, use:
```x
void icalproperty_set_x(
- icalproperty* prop,
+ icalproperty* prop,
char* v);
char* icalproperty_get_x(
@@ -784,7 +784,7 @@ char* icalproperty_get_x_name(
icalproperty* prop)
void icalproperty_set_x_name(
- icalproperty* prop,
+ icalproperty* prop,
char* name);
```
@@ -797,7 +797,7 @@ declares what operation a remote receiver should use to process a
component. For instance, if the `METHOD` is `REQUEST` and the component
is a `VEVENT`, the sender is probably asking the receiver to join in
a meeting. In this case, RFC5546 says that the component must specify
-a start time (`DTSTART`) and list the receiver as an attendee
+a start time (`DTSTART`) and list the receiver as an attendee
(`ATTENDEE`).
Libical can check these restrictions with the routine:
@@ -855,11 +855,11 @@ struct icaltimetype {
int minute;
int second;
int is_utc; /* 1-> time is in UTC timezone */
- int is_date; /* 1 -> interpret this as date. */
+ int is_date; /* 1 -> interpret this as date. */
};
```
-The `year`, `month`, `day`, `hour`, `minute` and `second` fields
+The `year`, `month`, `day`, `hour`, `minute` and `second` fields
hold the broken-out
time values. The `is_utc` field distinguishes between times in UTC and
a local time zone. The `is_date` field indicates if the time should
@@ -933,19 +933,19 @@ short icaltime_day_of_year(
struct icaltimetype t);
struct icaltimetype icaltime_from_day_of_year(
- short doy,
+ short doy,
short year);
short icaltime_day_of_week(
struct icaltimetype t);
short icaltime_start_doy_week(
- struct icaltimetype t,
+ struct icaltimetype t,
int fdow);
short icaltime_week_number(
- short day_of_month,
- short month,
+ short day_of_month,
+ short month,
short year);
short icaltime_days_in_month(
@@ -971,7 +971,7 @@ The compare routine works exactly like `strcmp()`, but on time structures.
```c
int icaltime_compare(
- struct icaltimetype a,
+ struct icaltimetype a,
struct icaltimetype b);
```
@@ -992,17 +992,17 @@ time all year.
```c
int icaltime_utc_offset(
- struct icaltimetype tt,
+ struct icaltimetype tt,
char* tzid);
int icaltime_local_utc_offset();
struct icaltimetype icaltime_as_utc(
- struct icaltimetype tt,
+ struct icaltimetype tt,
char* tzid);
struct icaltimetype icaltime_as_zone(
- struct icaltimetype tt,
+ struct icaltimetype tt,
char* tzid);
struct icaltimetype icaltime_as_local(
@@ -1040,38 +1040,38 @@ icalerrorenum icaldirset_commit(
icaldirset* store);
icalerrorenum icaldirset_add_component(
- icaldirset* store,
+ icaldirset* store,
icalcomponent* comp);
icalerrorenum icaldirset_remove_component(
- icaldirset* store,
+ icaldirset* store,
icalcomponent* comp);
int icaldirset_count_components(
- icaldirset* store,
+ icaldirset* store,
icalcomponent_kind kind);
icalerrorenum icaldirset_select(
- icaldirset* store,
+ icaldirset* store,
icalcomponent* gauge);
void icaldirset_clear(
icaldirset* store);
icalcomponent* icaldirset_fetch(
- icaldirset* store,
+ icaldirset* store,
const char* uid);
int icaldirset_has_uid(
- icaldirset* store,
+ icaldirset* store,
const char* uid);
icalcomponent* icaldirset_fetch_match(
- icaldirset* set,
+ icaldirset* set,
icalcomponent *c);
icalerrorenum icaldirset_modify(
- icaldirset* store,
+ icaldirset* store,
icalcomponent *oldc,
icalcomponent *newc);
@@ -1108,8 +1108,8 @@ icalfileset* icalfileset_new(
const char* path);
icalfileset* icalfileset_new_open(
- const char* path,
- int flags,
+ const char* path,
+ int flags,
int mode);
```
@@ -1130,7 +1130,7 @@ To add components to a set, use:
```c
icalerrorenum icalfileset_add_component(
- icalfileset* cluster,
+ icalfileset* cluster,
icalcomponent* child);
```
@@ -1175,7 +1175,7 @@ Then, you can add the gauge to the set with :
```c
icalerrorenum icalfileset_select(
- icalfileset* store,
+ icalfileset* store,
icalgauge* gauge);
```
@@ -1196,8 +1196,7 @@ DTSTART <= '20000106T120000Z'");
fs = icalfileset_new(path);
for (i = 0; i!= 10; i++){
- c = make_component(i); /* Make a new component where DTSTART
-has month of i */
+ c = make_component(i); /* Make a new component where DTSTART has month of i */
icalfileset_add_component(fs,c);
}
@@ -1222,42 +1221,42 @@ has month of i */
There are several other routines in the icalset interface, but they
not fully implemented yet.
-#### 5.5 Memory Management
+#### <a id="memory"></a>5.5 Memory Management
Libical relies heavily on dynamic allocation for both the core objects
and for the strings used to hold values. Some of this memory the library
caller owns and must free, and some of the memory is managed by the
library. Here is a summary of the memory rules.
-1. If the function name has "new" in it (such as `icalcomponent_new()`,
- or `icalproperty_new_from_string()`), the caller gets control
- of the memory. The caller also gets control over an object that is
- cloned via a function that ends with "_clone" (like `icalcomponent_clone()`)
+1. If the function name has "new" in it (such as `icalcomponent_new()`,
+ or `icalproperty_new_from_string()`), the caller gets control
+ of the memory. The caller also gets control over an object that is
+ cloned via a function that ends with "_clone" (like `icalcomponent_clone()`)
-2. If you got the memory from a routine with "clone" or "new" in it, you
- must call the corresponding `*_free()` routine to free the memory,
- for example use `icalcomponent_free()` to free objects created with
- `icalcomponent_new()` or `icalcomponent_clone()`
+2. If you got the memory from a routine with "clone" or "new" in it, you
+ must call the corresponding `*_free()` routine to free the memory,
+ for example use `icalcomponent_free()` to free objects created with
+ `icalcomponent_new()` or `icalcomponent_clone()`
-3. If the function name has "add" in it, the caller is transferring
- control of the memory to the routine, for example the function
- ` icalproperty_add_parameter()`
+3. If the function name has "add" in it, the caller is transferring
+ control of the memory to the routine, for example the function
+ ` icalproperty_add_parameter()`
-4. If the function name has "remove" in it, the caller passes in
- a pointer to an object and after the call returns, the caller owns
- the object. So, before you call `icalcomponent_remove_property(comp, foo)`,
- you do not own "foo" and after the call returns, you do.
+4. If the function name has "remove" in it, the caller passes in
+ a pointer to an object and after the call returns, the caller owns
+ the object. So, before you call `icalcomponent_remove_property(comp, foo)`,
+ you do not own "foo" and after the call returns, you do.
-5. If the routine returns a string and its name does NOT end in `_r`,
- libical owns the memory and will put it on a ring buffer to reclaim
- later. For example, `icalcomponent_as_ical_string()`. You better
- `strdup()` it if you want to keep it, and you don't have to delete it.
+5. If the routine returns a string and its name does NOT end in `_r`,
+ libical owns the memory and will put it on a ring buffer to reclaim
+ later. For example, `icalcomponent_as_ical_string()`. You better
+ `strdup()` it if you want to keep it, and you don't have to delete it.
-6. If the routine returns a string and its name *does* end in `_r`, the
- caller gets control of the memory and is responsible for freeing it.
- For example, `icalcomponent_as_ical_string_r()` does the same thing as
- `icalcomponent_as_ical_string()`, except you now have control of the
- string buffer it returns.
+6. If the routine returns a string and its name *does* end in `_r`, the
+ caller gets control of the memory and is responsible for freeing it.
+ For example, `icalcomponent_as_ical_string_r()` does the same thing as
+ `icalcomponent_as_ical_string()`, except you now have control of the
+ string buffer it returns.
### 5.6 Error Handling
@@ -1276,36 +1275,34 @@ of enum `icalerrorenum`.
Most routines will set the global error value `icalerrno` on errors.
This variable is an enumeration; permissible values can be found in
`libical/icalerror.h`. If the routine returns an enum icalerrorenum,
-then the return value will be the same as icalerrno. You can use
-`icalerror_strerror()` to get a string that describes the error.
+then the return value will be the same as icalerrno. You can use
+`icalerror_strerror()` to get a string that describes the error.
The enumerations are:
-- `ICAL_BADARG_ERROR`: One of the arguments to a routine was bad.
- Typically for a null pointer.
+- `ICAL_BADARG_ERROR`: One of the arguments to a routine was bad.
+ Typically for a null pointer.
-- `ICAL_NEWFAILED_ERROR`: A `new()` or `malloc()` failed.
+- `ICAL_NEWFAILED_ERROR`: A `new()` or `malloc()` failed.
-- `ICAL_MALFORMEDDATA_ERROR`: An input string was not in the correct
- format
+- `ICAL_MALFORMEDDATA_ERROR`: An input string was not in the correct format
-- `ICAL_PARSE_ERROR`: The parser failed to parse an incoming component
+- `ICAL_PARSE_ERROR`: The parser failed to parse an incoming component
-- `ICAL_INTERNAL_ERROR`: Largely equivalent to an assert
+- `ICAL_INTERNAL_ERROR`: Largely equivalent to an assert
-- `ICAL_FILE_ERROR`: A file operation failed. Check errno for more
- detail.
+- `ICAL_FILE_ERROR`: A file operation failed. Check errno for more detail.
-- `ICAL_ALLOCATION_ERROR`: ?
+- `ICAL_ALLOCATION_ERROR`: ?
-- `ICAL_USAGE_ERROR`: ?
+- `ICAL_USAGE_ERROR`: ?
-- `ICAL_NO_ERROR`: No error
+- `ICAL_NO_ERROR`: No error
-- `ICAL_MULTIPLEINCLUSION_ERROR`: ?
+- `ICAL_MULTIPLEINCLUSION_ERROR`: ?
-- `ICAL_TIMEDOUT_ERROR`: For CSTP and acquiring locks
+- `ICAL_TIMEDOUT_ERROR`: For CSTP and acquiring locks
-- `ICAL_UNKNOWN_ERROR`: ?
+- `ICAL_UNKNOWN_ERROR`: ?
#### 5.6.3 `X-LIC-ERROR` and `X-LIC-INVALID-COMPONENT`
@@ -1330,23 +1327,25 @@ RFC5545.
There are a few routines to manipulate error properties:
-| Routine | Purpose |
-|---------|---------|
-| `void icalrestriction_check()` | Check a component against RFC5546 and insert error properties to indicate non compliance |
-| `int icalcomponent_count_errors()` | Return the number of error properties in a component |
-| `void icalcomponent_strip_errors()` | Remove all error properties in a component |
-| `void icalcomponent_convert_errors()` | Convert some error properties into REQUESTS-STATUS proprties to indicate the inability to process the component as an iTIP request. |
-
+| Routine | Purpose |
+|---------------------------------------|------------------------------------------------------|
+| `void icalrestriction_check()` | Check a component against RFC5546 and insert error |
+| | properties to indicate non compliance |
+| `int icalcomponent_count_errors()` | Return the number of error properties in a component |
+| `void icalcomponent_strip_errors()` | Remove all error properties in a component |
+| `void icalcomponent_convert_errors()` | Convert some error properties into REQUESTS-STATUS |
+| | properties to indicate the inability to process the |
+| | component as an iTIP request. |
The types of errors are listed in icalerror.h. They are:
-- `ICAL_XLICERRORTYPE_COMPONENTPARSEERROR`
-- `ICAL_XLICERRORTYPE_PARAMETERVALUEPARSEERROR`
-- `ICAL_XLICERRORTYPE_PARAMETERNAMEPARSEERROR`
-- `ICAL_XLICERRORTYPE_PROPERTYPARSEERROR`
-- `ICAL_XLICERRORTYPE_VALUEPARSEERROR`
-- `ICAL_XLICERRORTYPE_UNKVCALPROP`
-- `ICAL_XLICERRORTYPE_INVALIDITIP`
+- `ICAL_XLICERRORTYPE_COMPONENTPARSEERROR`
+- `ICAL_XLICERRORTYPE_PARAMETERVALUEPARSEERROR`
+- `ICAL_XLICERRORTYPE_PARAMETERNAMEPARSEERROR`
+- `ICAL_XLICERRORTYPE_PROPERTYPARSEERROR`
+- `ICAL_XLICERRORTYPE_VALUEPARSEERROR`
+- `ICAL_XLICERRORTYPE_UNKVCALPROP`
+- `ICAL_XLICERRORTYPE_INVALIDITIP`
The libical parser will generate the error that end in `PARSEERROR` when
it encounters garbage in the input steam. `ICAL_XLICERRORTYPE_INVALIDITIP`
@@ -1394,7 +1393,7 @@ Enums that identify a component, property, value or parameter end with
`_COMPONENT`, `_PROPERTY`, `_VALUE`, or `_PARAMETER`"
Enums that identify a parameter value have the name of the parameter
-as the second word. For instance: `ICAL_ROLE_REQPARTICIPANT` or
+as the second word. For instance: `ICAL_ROLE_REQPARTICIPANT` or
`ICAL_PARTSTAT_ACCEPTED`.
The enums for the parts of a recurrence rule and request statuses