diff --git a/HISTORY.md b/HISTORY.md
index f000c549..86ed9a20 100644
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -21,6 +21,7 @@ http://visjs.org
See example 18_range_overflow.html.
- Fixed invalid css names for time axis grid, renamed hours class names from
`4-8h` to `h4-h8`.
+- Deprecated option `showCustomTime`. Use method `addCustomTime()` instead.
### Network
diff --git a/docs/timeline.html b/docs/timeline.html
index 822f8b48..ddde9db9 100644
--- a/docs/timeline.html
+++ b/docs/timeline.html
@@ -720,13 +720,6 @@ var options = {
Show a vertical bar at the current time.
-
-
showCustomTime
-
boolean
-
false
-
Show a vertical bar displaying a custom time. This line can be dragged by the user. The custom time can be utilized to show a state in the past or in the future. When the custom time bar is dragged by the user, the event timechange is fired repeatedly. After the bar is dragged, the event timechanged is fired once.
-
-
showMajorLabels
@@ -864,12 +857,13 @@ var options = {
-
addCustomTime(time[, id])
+
addCustomTime([time] [, id])
Number | String
- Only applicable when the option showCustomTime is true.
- Add new vertical bar representing custom time that can be dragged by the user. Parameter time can be a Date, Number, or String. Parameter id can be Number or String. If id is provided, it will be used as ID for the new vertical bar, otherwise the ID will be auto generated.
- Returns ID of the newly created bar.
+ Add new vertical bar representing a custom time that can be dragged by the user.
+ Parameter time can be a Date, Number, or String, and is new Date() by default.
+ Parameter id can be Number or String and is undefined by default.
+ Returns id of the created bar.
@@ -911,7 +905,7 @@ var options = {
getCustomTime([id])
Date
-
Retrieve the custom time. Only applicable when the option showCustomTime is true. If parameter id is provided, time of the custom time bar under that ID is returned.
+
Retrieve the custom time from the custom time bar with given id. Id is undefined by default.
@@ -1003,7 +997,9 @@ var options = {
setCustomTime(time [, id])
none
-
Adjust the custom time bar. Only applicable when the option showCustomTime is true. Parameter time can be a Date object, numeric timestamp, or ISO date string. Parameter id represents ID of the custom time bar, provided by addCustomTime method and can be a Number or String.
+
Adjust the time of a custom time bar.
+ Parameter time can be a Date object, numeric timestamp, or ISO date string.
+ Parameter id is the idof the custom time bar, and is undefined by default.