diff --git a/bar.go b/bar.go
index 567a748..1fa1a26 100644
--- a/bar.go
+++ b/bar.go
@@ -18,7 +18,7 @@
 // Filler interface.
 // Bar renders by calling Filler's Fill method. You can literally have
 // any bar kind, by implementing this interface and passing it to the
-// Add method.
+// mpb.Add function.
 type Filler interface {
 	Fill(w io.Writer, width int, stat *decor.Statistics)
 }
diff --git a/bar_option.go b/bar_option.go
index 4374cb5..b7f9fff 100644
--- a/bar_option.go
+++ b/bar_option.go
@@ -53,9 +53,8 @@
 	}
 }
 
-// BarRemoveOnComplete removes whole bar line on complete event. Any
-// decorators attached to the bar, having OnComplete action will not
-// have a chance to run its OnComplete action, because of this option.
+// BarRemoveOnComplete removes bar filler and decorators if any, on
+// complete event.
 func BarRemoveOnComplete() BarOption {
 	return func(s *bState) {
 		s.dropOnComplete = true
@@ -78,7 +77,7 @@
 	}
 }
 
-// BarClearOnComplete clears bar part of bar line on complete event.
+// BarClearOnComplete clears bar filler only, on complete event.
 func BarClearOnComplete() BarOption {
 	return func(s *bState) {
 		s.filler = makeClearOnCompleteFiller(s.filler)