diff --git a/docs/design/draft-bufferpool.txt b/docs/design/draft-bufferpool.txt
index 4061ee7675..c59b1be6d8 100644
--- a/docs/design/draft-bufferpool.txt
+++ b/docs/design/draft-bufferpool.txt
@@ -111,7 +111,7 @@ negotiate a buffer pool with the downstream element. We propose a simple
 scheme where a sink can propose a bufferpool and some configuration and where
 the source can choose to use this allocator or use its own.
 
-The algorithm for doing this is rougly like this:
+The algorithm for doing this is roughly like this:
 
 
    /* srcpad knows media type and size of buffers and is ready to
diff --git a/gst/gstbufferpool.c b/gst/gstbufferpool.c
index 6e85495185..7ae314e669 100644
--- a/gst/gstbufferpool.c
+++ b/gst/gstbufferpool.c
@@ -486,7 +486,8 @@ gst_buffer_pool_get_config (GstBufferPool * pool)
 
 /**
  * gst_buffer_pool_config_set:
- * @pool: a #GstBufferPool
+ * @config: a #GstBufferPool
+ * @caps: caps for the buffers
  * @size: the size of each buffer, not including pre and post fix
  * @min_buffers: the minimum amount of buffers to allocate.
  * @max_buffers: the maximum amount of buffers to allocate or 0 for unlimited.
@@ -515,7 +516,8 @@ gst_buffer_pool_config_set (GstStructure * config, const GstCaps * caps,
 
 /**
  * gst_buffer_pool_config_get:
- * @pool: a #GstBufferPool
+ * @config: a #GstBufferPool
+ * @caps: the caps of buffers
  * @size: the size of each buffer, not including pre and post fix
  * @min_buffers: the minimum amount of buffers to allocate.
  * @max_buffers: the maximum amount of buffers to allocate or 0 for unlimited.