Better mark GtkAlignment as deprecated

- Move the class to the Deprecated section.
- Warning at the top of the class description.
- A missing property was not marked as deprecated.
- Update doc of gtk_container_set_border_width() to not mention
  GtkAlignment.

https://bugzilla.gnome.org/show_bug.cgi?id=736622